VSCode 与 Docker 集成可实现环境一致性与快速部署：安装 Docker 扩展、配置本地 Docker 环境、使用 Dev Container 启动隔离环境、调试容器内 Node.js 应用、自定义 Dockerfile 构建推送开发镜像。
如果您希望在开发过程中实现环境一致性与快速部署，vscode 与 docker 的集成可提供轻量、可复现的容器化开发体验。以下是实现该集成的具体路径：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 VSCode 的 Docker 扩展
该扩展为 VSCode 提供对 Docker 镜像、容器、Dockerfile 和 docker-compose.yml 的原生支持，使资源管理与调试操作直接内嵌于编辑器界面。
1、启动 VSCode，点击左侧活动栏中的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Docker，找到由 Microsoft 官方发布的 Docker 扩展。
3、点击“安装”，安装完成后重启 VSCode 或点击“重新加载”按钮。
二、配置本地 Docker 环境并验证连接
VSCode 的 Docker 扩展需与本地运行的 Docker 守护进程通信，因此必须确保 Docker Desktop 已正确安装并处于运行状态。
1、打开终端，执行 docker –version 确认 CLI 可用。
2、执行 docker info 检查守护进程是否响应；若返回详细信息，则连接正常。
3、在 VSCode 中点击左下角状态栏的 Docker 图标，确认显示 Connected to Docker。
三、使用 Dev Container 快速启动隔离开发环境
Dev Container 是 VSCode 提供的标准化容器开发方案，通过 .devcontainer/devcontainer.json 定义环境依赖与启动行为，无需手动构建或进入容器。
1、在项目根目录新建文件夹 .devcontainer。
2、在该文件夹内创建 devcontainer.json，内容包含 image 或 dockerfile 字段以指定基础环境。
3、按下 Cmd+Shift+P，输入 Dev Containers: Reopen in Container 并执行，VSCode 将自动构建镜像并启动容器内工作区。
四、在容器内调试 Node.js 应用
利用 Dev Container 的 端口 转发与调试协议桥接能力，可在宿主机 VSCode 中直接调试运行于容器内的 Node.js 进程。
1、确保 devcontainer.json 中已设置 forwardPorts 数组，例如 [3000]。
2、在容器内启动应用时添加调试参数：node –inspect=0.0.0.0:9229 app.js。
3、在 VSCode 中配置 launch.json，选择 Remote Attach 类型，并将 port 设为 9229，address 设为 localhost。
五、基于 Dockerfile 构建并推送自定义开发镜像
当预置镜像无法满足特定 工具 链需求时，可通过自定义 Dockerfile 构建专属开发镜像，提升团队环境统一性。
1、在项目根目录创建 Dockerfile.dev，以 FROM node:18-slim 为基础，追加 apt-get install -y curl git 等开发依赖。
2、在 devcontainer.json 中将 dockerFile 字段指向该文件，并设置 context 为项目根路径。
3、执行 docker build -f Dockerfile.dev -t my-dev-env . 构建镜像，再通过 docker tag 与 docker push 推送至私有仓库。
