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 推送至私有仓库。
