Dev Containers 镜像文档

1. 镜像概述和主要用途

Dev Containers 镜像是为支持 Dev Container Specification 的工具和服务设计的标准化开发环境镜像。这些镜像预配置了开发所需的运行时、工具链和依赖项，其内容及对应的 devcontainer.json 配置文件与 devcontainers/images 仓库的发布版本紧密关联。主要用途是提供一致、可复现的开发环境，消除"在我机器上能运行"的问题，支持多语言、多框架项目的快速搭建和团队协作。

2. 核心功能和特性

2.1 多环境支持

• 基础操作系统覆盖：Alpine、Debian（Bookworm、Bullseye、Buster）、Ubuntu（Noble、Jammy、Focal、Bionic）等主流发行版。
• 多语言/框架支持：包含 C++、.NET、Go、Java、JavaScript/Node.js、Jekyll、PHP、Python、Anaconda、Miniconda、Ruby、Rust、TypeScript/Node.js 等开发环境。

2.2 标准化与兼容性

• 严格遵循 Dev Container Specification，确保与 VS Code Dev Containers、GitHub Codespaces 等工具无缝集成。
• 提供语义化版本标签，支持灵活的更新策略（如固定主版本、次版本或补丁版本）。

2.3 架构适配

• 部分镜像支持 ARM64 架构（需选择特定操作系统标签，如 Debian 11/Bullseye）。

2.4 开箱即用

• 预配置开发工具链（编译器、调试器、包管理器等），无需手动安装依赖。

3. 适用场景和适用范围

3.1 开发环境标准化

• 个人项目：统一本地与远程开发环境配置。
• 团队协作：确保所有成员使用一致的开发环境，减少环境差异导致的问题。

3.2 多语言项目开发

• 直接使用对应语言的预配置镜像（如 Java 21、Python 3.12、Go 1.23 等），快速启动开发。

3.3 教育与培训

• 快速搭建标准化教学环境，学员无需手动配置开发工具。

3.4 CI/CD 集成

• 作为开发阶段容器，与 CI/CD 流程结合，实现"开发即部署"的一致性。

4. 镜像列表与标签

4.1 基础镜像

• 仓库：mcr.microsoft.com/devcontainers/base
  详细信息：GitHub | 所有标签：MCR
  可用标签：
  • Alpine 系列：alpine, alpine-3.20, alpine-3.19, alpine-3.18, alpine-3.17
  • Debian 系列：debian, bookworm, debian-12, bullseye, debian-11, debian-10
  • Ubuntu 系列：ubuntu, jammy, ubuntu-22.04, focal, ubuntu-20.04, bionic, ubuntu-18.04

4.2 语言/框架专用镜像

4.2.1 C++ 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/cpp
  详细信息：GitHub | 所有标签：MCR
  可用标签：
  • Debian 系列：bookworm, debian-12, bullseye, debian-11
  • Ubuntu 系列：noble, ubuntu-24.04, jammy, ubuntu-22.04, focal, ubuntu-20.04, bionic, ubuntu-18.04

4.2.2 .NET 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/dotnet
  详细信息：GitHub | 所有标签：MCR
  可用标签：9.0, 8.0

4.2.3 Go 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/go
  详细信息：GitHub | 所有标签：MCR
  可用标签：1, 1.23, 1.22, 1-bookworm, 1.23-bookworm, 1.22-bookworm, 1-bullseye, 1.23-bullseye, 1.22-bullseye, 1-buster, 1.20-buster, 1.19-bullseye, 1.19-buster

4.2.4 Java 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/java
  详细信息：GitHub | 所有标签：MCR
  可用标签：
  • Java 21：21, 21-bookworm, 21-bullseye
  • Java 17：17, 17-bookworm, 17-bullseye
  • Java 11：11, 11-bookworm, 11-bullseye

4.2.5 JavaScript/Node.js 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/javascript-node
  详细信息：GitHub | 所有标签：MCR
  可用标签：
  • Node.js 22：22, 22-bookworm, 22-bullseye
  • Node.js 20：20, 20-bookworm, 20-bullseye
  • Node.js 18：18, 18-bookworm, 18-bullseye

4.2.6 Jekyll 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/jekyll
  详细信息：GitHub | 所有标签：MCR
  可用标签：bookworm, bullseye, buster

4.2.7 PHP 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/php
  详细信息：GitHub | 所有标签：MCR
  可用标签：
  • PHP 8.3：8, 8.3, 8-bookworm, 8.3-bookworm, 8-bullseye, 8.3-bullseye
  • PHP 8.2：8.2, 8.2-bookworm, 8.2-bullseye

4.2.8 Python 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/python
  详细信息：GitHub | 所有标签：MCR
  可用标签：
  • Python 3.12：3, 3-bookworm, 3.12-bookworm, 3-bullseye, 3.12-bullseye
  • Python 3.11：3.11, 3.11-bookworm, 3.11-bullseye
  • Python 3.10：3.10, 3.10-bookworm, 3.10-bullseye
  • Python 3.9：3.9, 3.9-bookworm, 3.9-bullseye

4.2.9 Anaconda/Miniconda 镜像

• Anaconda：mcr.microsoft.com/devcontainers/anaconda
  详细信息：GitHub | 所有标签：MCR
  可用标签：3

• Miniconda：mcr.microsoft.com/devcontainers/miniconda
  详细信息：GitHub | 所有标签：MCR
  可用标签：3

4.2.10 Ruby 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/ruby
  详细信息：GitHub | 所有标签：MCR
  可用标签：3, 3.1, 3.2, 3.3, 3-bookworm, 3.1-bookworm, 3.2-bookworm, 3.3-bookworm, 3-bullseye, 3.1-bullseye, 3.2-bullseye, 3.3-bullseye

4.2.11 Rust 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/rust
  详细信息：GitHub | 所有标签：MCR
  可用标签：bookworm, bullseye, 1-bookworm, 1-bullseye

4.2.12 TypeScript/Node.js 开发镜像

• 仓库：mcr.microsoft.com/devcontainers/typescript-node
  详细信息：GitHub | 所有标签：MCR
  可用标签：
  • Node.js 22：22, 22-bookworm, 22-bullseye
  • Node.js 20：20, 20-bookworm, 20-bullseye
  • Node.js 18：18, 18-bookworm, 18-bullseye

4.2.13 通用开发镜像

• 仓库：mcr.microsoft.com/devcontainers/universal
  详细信息：GitHub | 所有标签：MCR

5. 使用方法和配置说明

5.1 标签选择策略

• 基础标签：如 debian（自动指向最新 Debian 版本），适合希望自动更新基础环境的场景。
• 特定版本标签：如 alpine-3.20、java-17-bookworm，适合需要固定操作系统或语言版本的场景。
• 语义化版本标签：格式为 <major>-<language>-<os>（如 0-17-bullseye），<major>.<minor>-<language>-<os>（如 0.205-17-bullseye），或 <major>.<minor>.<patch>-<language>-<os>（如 0.205.0-17-bullseye），推荐使用主版本标签（如 0-17-bullseye）以平衡稳定性和更新频率。

5.2 Docker 部署示例

5.2.1 直接运行基础镜像

# 启动 Debian 12 (Bookworm) 基础开发环境
docker run -it --rm mcr.microsoft.com/devcontainers/base:bookworm

5.2.2 在 devcontainer.json 中配置 Java 环境

在项目根目录的 .devcontainer/devcontainer.json 中配置：

{
  "image": "mcr.microsoft.com/devcontainers/java:17-bookworm",
  "customizations": {
    "vscode": {
      "extensions": [
        "vscjava.vscode-java-pack",  // Java 开发扩展包
        "redhat.java",               // Java 语言支持
        "vscjava.vscode-maven"       // Maven 支持
      ]
    }
  },
  "postCreateCommand": "mvn clean install"  // 容器创建后自动执行的命令
}

5.2.3 使用 Docker Compose 配置多服务环境

version: '3.8'
services:
  dev:
    image: mcr.microsoft.com/devcontainers/python:3.12-bookworm
    volumes:
      - .:/workspace:cached
    command: sleep infinity  # 保持容器运行
    environment:
      - PYTHONUNBUFFERED=1

5.3 ARM64 架构支持说明

• 支持的操作系统：仅 Debian 11 (Bullseye) 和 Ubuntu 18.04 (Bionic) 镜像提供 ARM64 版本。
• 使用方法：选择带 bullseye 或 bionic 后缀的标签，例如：

  docker run -it --rm mcr.microsoft.com/devcontainers/java:17-bullseye  # ARM64 兼容
  

• 限制：部分镜像（如 .NET）因依赖扩展不支持 ARM64，具体以镜像标签列表为准。

6. 贡献与反馈

6.1 贡献指南

若需贡献代码或改进，参考 How to Contribute 文档。

6.2 问题反馈

与镜像相关的问题可在 devcontainers/images 仓库提交 Issue。