<p>答案是使用vscode Remote – Containers扩展结合docker实现远程调试。首先安装Docker、VSCode及Remote – Containers扩展，然后在项目根目录创建.devcontainer文件夹并配置devcontainer.json，指定基础镜像、转发端口、启动后命令和所需扩展，可选自定义Dockerfile。接着通过命令面板执行“Remote-Containers: Reopen in Container”让VSCode自动构建并进入容器环境。容器启动后，在终端以调试模式运行应用（如node.js的–inspect参数），最后在.vscode/launch.json中设置调试配置，指定端口9229和路径映射，选择“Attach”模式连接进程，即可实现断点调试，获得本地化开发体验。</p>

要在 VSCode 中实现对容器内应用程序的远程调试，核心是结合 Docker 与 VSCode Remote – Containers 扩展。整个过程不需要手动配置复杂的 ssh 或端口映射，只需正确设置开发容器环境即可。

安装必要工具和扩展

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

• Docker：运行容器的基础平台
• VSCode：推荐使用最新稳定版
• VSCode 扩展：“Remote – Containers”（由 microsoft 提供）

安装完成后，VSCode 就能识别项目中的容器配置，并在容器中启动开发环境。

为项目添加 devcontainer 配置

在项目根目录创建 .devcontainer 文件夹，并添加两个关键文件：

1. devcontainer.json：定义容器环境

示例配置：

{   "name": "My app Dev Container",   "image": "node:18", // 可替换为你的应用基础镜像   "forwardPorts": [3000], // 转发应用端口   "postAttachCommand": "npm install", // 连接后自动执行   "customizations": {     "vscode": {       "extensions": ["ms-vscode.node-debug2", "dbaeumer.vscode-eslint"]     }   },   "appPort": [9229] // 启用调试端口（如 node.js 调试） }

2. 可选：Dockerfile 或直接使用 image

Calliper 文档对比神器

文档内容对比神器

28

查看详情

如果需要自定义环境，可在 .devcontainer 中添加 Dockerfile，并在 devcontainer.json 中引用：

"dockerFile": "Dockerfile"

在容器中打开项目并启动调试

右键点击项目文件夹或使用命令面板：

• 按 Ctrl+Shift+P 打开命令面板
• 输入 “Remote-Containers: Reopen in Container”
• VSCode 会自动构建/启动容器，并挂载项目代码

容器就绪后：

• 打开终端（Terminal），在容器内启动应用并启用调试模式
• 例如 Node.js 应用：npm run debug 或 node –inspect=0.0.0.0:9229 server.js

配置 VSCode 启动调试会话

在 .vscode/launch.json 中添加调试配置：

{   "version": "0.2.0",   "configurations": [     {       "name": "Attach to Node.js in Container",       "type": "node",       "request": "attach",       "port": 9229,       "address": "localhost",       "localRoot": "${workspaceFolder}",       "remoteRoot": "/workspaces/${workspaceFolderBasename}"     }   ] }

点击“运行和调试”侧边栏，选择该配置并启动，即可连接到容器内的进程进行断点调试。

基本上就这些。只要容器正常运行且调试端口开放，VSCode 就能无缝接入，实现如同本地开发一样的体验。