VS Code 调试 Docker 容器内应用需容器暴露调试端口、应用以调试模式监听 0.0.0.0、正确配置 launch.json 的 attach 或 Remote-Containers 方式，并注意源码路径映射与网络绑定细节。
在 VS Code 中调试 Docker 容器内的应用，核心是让调试器连接到容器中运行的进程（比如 Node.js、Python 或 .NET 应用），而不是直接在宿主机上启动。关键在于：容器需暴露调试端口、启用调试模式、并配置 VS Code 的 launch.json 正确转发或直连。
确保容器内应用支持远程调试
不同语言的调试方式不同，但共性是：应用必须以“调试模式”启动，并监听一个可被外部访问的端口（通常是 localhost:9229、5678、5005 等）。
-
Node.js：启动命令加
--inspect=0.0.0.0:9229（注意用0.0.0.0而非127.0.0.1，否则容器内 localhost 无法被外部访问） -
Python（使用 debugpy）：在代码开头插入
import debugpy; debugpy.listen(("0.0.0.0", 5678))，并确保已安装debugpy -
.NET Core：用
dotnet run --configuration Debug --no-launch-profile --launch-profile ""并配合vsdbg镜像或容器内安装调试器
正确暴露和映射调试端口
Docker 默认隔离网络，必须显式发布调试端口，且避免仅用 -p 9229:9229 就完事——某些调试协议（如 Chrome DevTools Protocol）需要额外端口或 WebSocket 支持。
- 运行容器时加
-p 9229:9229（Node）、-p 5678:5678（Python）等 - 若调试器依赖文件系统映射（如断点源码路径），建议挂载源码目录：
-v $(pwd):/app，并确保容器内工作目录与本地一致 - 对于 Node.js，推荐加
--inspect-brk实现启动即暂停，方便 VS Code 在第一行就介入
配置 VS Code 的 launch.json
不依赖 Docker 扩展也能调试，但推荐使用官方 Docker 扩展 + Remote - Containers 扩展实现更无缝体验。两种主流方式：
-
方式一：Attach 到运行中的容器
适用于已启动的容器。在.vscode/launch.json中添加attach类型配置，指定端口、地址（通常为localhost）、以及源码映射（localRoot/remoteRoot）。例如 Node.js：
{
"type": "node",
"request": "attach",
"name": "Attach to Docker",
"port": 9229,
"address": "localhost",
"localRoot": "${workspaceFolder}",
"remoteRoot": "/app",
"skipFiles": ["<node_internals>/**"]
}-
方式二：Remote-Containers 开发容器
打开文件夹 → 按Ctrl+Shift+P→ “Remote-Containers: Reopen in Container”，VS Code 会自动构建/启动容器，并在容器内运行整个编辑器后端。此时调试就像在本地一样自然，无需手动 attach。
常见问题排查
连不上？大概率卡在这几个点：
- 容器内应用没真正监听
0.0.0.0（只监听127.0.0.1或localhost）→ 查看进程绑定：netstat -tuln | grep 9229 - 防火墙或 Docker Desktop 设置阻止端口映射 → 检查
docker ps输出中 PORTS 列是否显示0.0.0.0:9229->9229/tcp - 源码路径不匹配导致断点灰掉 → 严格核对
localRoot和remoteRoot，尤其注意路径结尾斜杠和大小写 - Python debugpy 启动后未调用
debugpy.wait_for_client()→ 若加了--wait-for-client参数，代码需主动等待
基本上就这些。调试 Docker 内应用不复杂，但容易忽略网络绑定和路径映射这两个细节。
