如何使用VS Code调试在Docker容器中运行的应用程序-VSCode-PHP中文网

如何使用VS Code调试在Docker容器中运行的应用程序

P粉986688829

发布： 2025-12-05 21:17:02

原创

293人浏览过

答案：使用VS Code调试Docker容器内应用需配置支持调试的镜像并暴露端口，如Node.js添加--inspect=0.0.0.0:9229；启动容器时映射调试端口-p 9229:9229并挂载代码卷；在launch.json中设置attach模式，指定端口、地址及路径映射；最后启动容器并在VS Code中附加调试器即可命中断点。

如何使用vs code调试在docker容器中运行的应用程序

调试运行在 Docker 容器中的应用程序是开发中常见的需求。使用 VS Code 可以方便地实现断点调试，只要正确配置开发环境和容器运行参数。关键是让调试器能连接到容器内的进程，并确保代码同步和端口映射正常。

1. 准备支持调试的 Docker 镜像

你的镜像需要包含调试工具并暴露调试端口。以 Node.js 应用为例，修改 Dockerfile：

使用调试模式启动应用，例如 Node.js 添加 --inspect=0.0.0.0:9229
确保监听地址为 0.0.0.0 而非 localhost，否则外部无法访问
在 Dockerfile 中开放调试端口，如 EXPOSE 9229

示例 Dockerfile（Node.js）：
CMD [ "node", "--inspect=0.0.0.0:9229", "server.js" ]

2. 启动容器并映射调试端口

运行容器时必须将调试端口从容器映射到宿主机：

使用 -p 9229:9229 将容器的 9229 端口映射到本地
确保容器内的代码与本地一致，可通过挂载卷实现热更新
推荐使用 -v ${PWD}:/app 挂载源码目录

docker run -p 3000:3000 -p 9229:9229 -v ${PWD}:/app myapp

3. 配置 VS Code 的 launch.json

在项目根目录的 .vscode/launch.json 中添加调试配置：

芝士饼

芝士饼是一个一站式AI原生应用开发平台，简单几步即可完成应用的创建与发布。

查看详情

设置类型为 node
使用 attach 模式连接到远程进程
指定本地代码路径与容器中路径的映射关系

示例配置：
{ "type": "node", "request": "attach", "name": "Attach to Docker", "port": 9229, "address": "localhost", "localRoot": "${workspaceFolder}", "remoteRoot": "/app" }