darklang/dark-base

镜像概述

该Docker镜像为darklang/dark项目（函数式编程语言及开发平台）提供标准化开发容器环境，旨在消除开发环境配置差异，确保所有开发者使用一致的依赖和工具链，简化darklang应用的开发、调试与贡献流程。

核心功能

• 预配置依赖：包含darklang编译器、运行时环境、构建工具等项目开发必需依赖
• 开发工具集成：内置代码格式化工具、调试器、版本控制客户端等开发辅助工具
• 环境标准化：统一开发环境配置，避免"在我机器上能运行"的环境一致性问题
• 多工具支持：兼容VS Code Dev Containers扩展、JetBrains远程开发等主流开发工具
• 轻量级设计：基于精简基础镜像构建，仅包含开发必需组件，减少资源占用

使用场景

• darklang/dark项目新开发者快速搭建本地开发环境
• 团队协作中确保所有成员使用完全一致的开发环境
• 临时开发环境或多版本并行开发时的环境隔离
• 教育或演示场景中快速部署可交互的darklang开发环境

使用方法

前提条件

• 安装Docker Engine (20.10+) 或 Docker Desktop
• 安装Git（用于克隆项目代码）
• （推荐）安装VS Code及Dev Containers扩展（ms-vscode-remote.remote-containers）

通过VS Code集成使用（推荐流程）

1. 克隆darklang/dark项目仓库：

   bash
   git clone https://github.com/darklang/dark.git && cd dark
   

2. 打开VS Code并安装Dev Containers扩展

3. 在VS Code中打开项目文件夹：File > Open Folder，选择克隆的dark目录

4. 启动开发容器：

   • 按下F1或Ctrl+Shift+P打开命令面板
   • 输入并选择Dev Containers: Reopen in Container
   • 容器将自动构建/拉取并启动，VS Code将连接到容器内环境

Docker Run命令手动启动

适用于无VS Code环境或需要手动控制容器的场景：

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  --name dark-dev-env \
  darklang/dark-devcontainer:latest \
  /bin/bash

参数说明：

• -v $(pwd):/workspace：将当前目录（dark项目根目录）挂载到容器内/workspace
• -w /workspace：设置工作目录为/workspace
• --rm：容器退出后自动删除
• -it：交互式终端支持

Docker Compose配置

创建docker-compose.yml文件进行更复杂的环境配置：

yaml
version: '3.8'
services:
  dark-dev:
    image: darklang/dark-devcontainer:latest
    volumes:
      - ./:/workspace:cached  # 缓存挂载提升文件访问性能
      - dark-dev-cache:/home/dev/.cache  # 持久化开发缓存
    working_dir: /workspace
    stdin_open: true
    tty: true
    environment:
      - DARK_ENV=development
      - LOG_LEVEL=info
    ports:
      - "3000:3000"  # 映射应用开发服务器端口

volumes:
  dark-dev-cache:  # 定义持久化缓存卷

启动命令：docker-compose up -d && docker-compose exec dark-dev bash

注意事项

• 首次启动需下载完整镜像，视网络情况可能需要5-10分钟
• Windows系统用户需确保WSL2或Docker Desktop正确配置，避免文件系统性能问题
• 如需自定义开发环境，可基于此镜像创建Dockerfile并添加额外工具：FROM darklang/dark-devcontainer:latest
• 项目依赖更新时，建议重新拉取最新镜像以获取更新的依赖配置