安装docker、vscode及Dev Containers扩展；2. 在项目根目录创建.devcontainer文件夹并配置Dockerfile和devcontainer.json；3. 点击VSCode左下角绿色按钮打开容器，自动构建环境并进入开发。

为了在 VSCode 中实现与 Docker 的无缝集成，进行容器内开发和调试，关键是利用 Dev Containers（Development Containers）功能。这一功能由 VSCode 的 Dev Containers 扩展提供，允许你将整个开发环境封装在容器中，真正做到“开箱即用”、环境一致、可复现。

1. 安装必要工具

确保本地已安装以下组件：

• Docker：桌面版或引擎服务正常运行
• VSCode：推荐使用最新稳定版本
• Dev Containers 扩展：在扩展市场搜索 “Dev Containers” 并安装（官方扩展名为 ms-vscode-remote.remote-containers）

2. 创建容器化开发环境

VSCode 支持通过配置文件自动构建并进入容器环境。你需要在项目根目录下创建 .devcontainer 文件夹，并添加配置文件。

基本结构如下：

 .devcontainer/ ├── devcontainer.json └── Dockerfile 

示例：Dockerfile

定义开发所需的基础环境，例如 node.js：

 FROM node:18-slim <h1>安装常用工具（可选）</h1><p>RUN apt-get update && apt-get install -y  git  curl  vim  && rm -rf /var/lib/apt/lists/*</p><p>WORKDIR /workspace</p>

示例：devcontainer.json

白瓜面试

白瓜面试 – AI面试助手,辅助笔试面试神器

40

查看详情

告诉 VSCode 如何启动容器：

 {   "name": "My Dev Container",   "build": {     "dockerfile": "Dockerfile"   },   "workspaceFolder": "/workspace",   "remoteUser": "node",   "customizations": {     "vscode": {       "extensions": [         "dbaeumer.vscode-eslint",         "ms-vscode.node-debug2"       ],       "settings": {         "terminal.integrated.shell.linux": "/bin/bash"       }     }   },   "postAttachCommand": "npm install" } 

3. 启动容器内开发

完成配置后，执行以下步骤：

• 点击左下角绿色 >
• 选择 “Reopen in Container” 或 “Open Folder in Container…”
• VSCode 将自动构建镜像、启动容器，并挂载当前项目目录
• 连接成功后，所有终端、编辑、调试操作都在容器内执行

此时打开的终端显示的是容器内部环境，npm、python、gcc 等命令均来自容器镜像。

4. 调试容器内应用

调试过程与本地几乎无异，只需注意路径和端口映射。

以 node.js 应用为例：

• 在 .vscode/launch.json 中配置调试器：

 {   "version": "0.2.0",   "configurations": [     {       "name": "Launch App in Container",       "type": "node",       "request": "launch",       "program": "/workspace/index.js",       "console": "integratedTerminal",       "cwd": "/workspace"     }   ] } 

• 确保代码路径与容器内路径一致（通常通过挂载自动完成）
• 设置断点，按 F5 启动调试，VSCode 将在容器中运行并调试程序

对于 python、go、java 等语言，只需安装对应调试扩展并配置 launch.json 即可。

5. 高级技巧与最佳实践

• 复用已有镜像：可在 devcontainer.json 中使用 “image” 字段直接指定预建镜像
• 持久化依赖：将 node_modules 挂载为卷，避免每次重建都重装
• 多容器开发：支持 docker-compose.yml 配置多个服务（如 app + db）
• 权限管理：合理设置 remoteUser，避免 root 权限滥用
• .env 文件支持：可通过 “remoteEnv” 字段注入环境变量

基本上就这些。通过 Dev Containers，你可以把开发环境“打包带走”，团队成员不再需要“在我机器上能跑”。容器即开发环境，VSCode 让这一切变得透明而高效。