可利用 VSCode 的 Dev Containers 功能在 Docker 容器中隔离开发，需安装 Docker Desktop、Dev Containers 扩展和 git；支持自动生成配置、自定义 Dockerfile、附加运行容器、端口转发及容器内调试。
如果您希望在隔离的环境中进行代码开发与调试，同时保持本地开发体验的一致性，则可以利用 VSCode 的 Dev Containers 功能将开发环境直接运行于 Docker 容器内。以下是实现该目标的具体方法：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装必要组件
启用容器化开发前，需确保本地已安装支持 Dev Containers 的核心工具链。VSCode 通过这些组件与 Docker 守护进程通信，并构建、启动及连接开发容器。
1、下载并安装最新稳定版 Docker Desktop，安装过程中启用 Docker Engine 和 Kubernetes（可选）。
2、打开 VSCode，进入扩展市场，搜索并安装官方扩展 Dev Containers（由 Microsoft 发布，图标为蓝色容器）。
3、确认系统中已安装 git 命令行工具，用于克隆项目及初始化容器配置。
二、基于现有项目启用 Dev Container
当项目尚未包含 Dev Container 配置时，VSCode 可自动生成适配的 .devcontainer/devcontainer.json 文件，并据此构建容器环境。该方式适用于快速启动标准化开发环境。
1、在 VSCode 中打开目标项目文件夹。
2、按下 Command + Shift + P（macOS）调出命令面板，输入并选择 Dev Containers: Add Development Container Configuration Files...。
3、从模板列表中选择匹配项目语言的配置，例如 Node.js & TypeScript 或 Python 3。
4、VSCode 自动在项目根目录下创建 .devcontainer 文件夹及 devcontainer.json 和 Dockerfile（如适用）。
三、使用自定义 Dockerfile 构建容器
当标准模板无法满足依赖或运行时要求时，可通过编写自定义 Dockerfile 精确控制基础镜像、系统包、工具链及权限设置，从而构建完全可控的开发环境。
1、在 .devcontainer 目录中新建文件 Dockerfile，内容以 FROM 指令起始，例如 FROM mcr.microsoft.com/vscode/devcontainers/python:3-3.11。
2、在 Dockerfile 中添加 RUN 指令安装额外依赖，例如 RUN apt-get update && apt-get install -y curl jq。
3、修改 devcontainer.json，将 image 字段替换为 build 对象，指定 dockerfile 路径与 context 范围。
四、附加到正在运行的容器进行调试
对于已在宿主机上运行的容器（如通过 docker run 或 docker-compose 启动），VSCode 支持直接附加调试器，无需重建环境，适用于复现线上问题或调试已部署服务。
1、确保目标容器已以交互模式运行，并挂载了源码目录，例如使用 -v $(pwd):/workspace 参数。
2、在 VSCode 中执行命令 Dev Containers: Attach to Running Container...。
3、从列表中选择目标容器，VSCode 将自动检测运行时并安装对应平台的 VS Code Server。
4、附加成功后，可在容器内直接打开文件、设置断点、启动调试会话，并查看容器内的进程与日志输出。
五、配置端口转发与调试启动项
开发过程中常需访问容器内运行的服务（如本地 Web 服务器或 API），VSCode 提供端口自动转发机制，并支持在 launch.json 中定义调试入口，实现一键启动与调试。
1、在 devcontainer.json 的 forwardPorts 数组中添加端口号，例如 3000 或 8080，保存后 VSCode 自动建立转发隧道。
2、在容器内打开项目文件夹后，点击左侧活动栏的调试图标，选择 create a launch.json file。
3、根据运行时选择对应环境模板（如 Python 或 Node.js），编辑 program 字段指向入口文件，例如 "program": "./app.py"。
4、按 F5 启动调试，VSCode 将在容器内执行程序并同步调试状态。
