VSCode附加运行中Docker容器无法设置断点及代码导航问题

问题根源 #

断点失效、右键无代码导航选项，本质是VSCode没识别出这是个标准的Node.js项目，同时你也没以调试模式启动Node进程。

修复步骤 #

1. 补全项目配置文件 #

在容器的/app目录下创建两个关键文件：

• package.json：标记Node项目并定义调试启动脚本

{
  "name": "docker-node-demo",
  "version": "1.0.0",
  "scripts": {
    "debug": "node --inspect=0.0.0.0:9229 app.js"
  }
}

• jsconfig.json：给VSCode提供代码导航、智能提示的依据

{
  "compilerOptions": {
    "module": "CommonJS",
    "target": "ES6"
  },
  "exclude": ["node_modules"]
}

2. 配置VSCode调试项 #

在VSCode里打开容器的/app文件夹后，按F5，选择「Node.js」环境，自动生成.vscode/launch.json，确保内容如下：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "启动调试",
      "program": "${workspaceFolder}/app.js",
      "skipFiles": ["<node_internals>/**"]
    }
  ]
}

3. 用调试模式启动进程 #

• 直接按F5启动VSCode调试：此时Node会自动以调试模式运行，断点会正常触发，代码导航功能也会生效。
• 手动终端启动：在VSCode集成终端执行npm run debug，然后在调试面板选择「Attach to Process」连接到调试进程。

可选优化：Dockerfile暴露调试端口 #

如果需要从宿主机直接调试容器内进程，可在Dockerfile末尾加一行：

EXPOSE 9229

然后重新构建镜像：docker build -t appimage .，启动容器时可加-p 9229:9229映射端口（Dev Container附加时一般不需要手动映射）。

内容的提问来源于stack exchange，提问作者user14427500