VSCode可调试多容器应用，但需手动配置launch.json与docker-compose.yml联动：docker-compose.yml中须暴露调试端口并启用调试模式（如Python用debugpy监听0.0.0.0:5678），launch.json中为每个服务配置独立attach项，确保host为localhost、port为容器内端口、pathMappings路径严格一致。
VSCode 能直接调试多容器应用，但必须手动配好 launch.json 和 docker-compose.yml 的联动点，光靠 Docker 扩展点“Up”是进不了断点的。
docker-compose.yml 里必须暴露调试端口并启用调试模式
调试不是自动发生的——容器进程得主动监听调试器连接，且端口要透出到宿主机。比如 Python 服务不能只写 python app.py，得改成：
command: python -m debugpy --listen 0.0.0.0:5678 --wait-for-client app.py
同时在 ports 下映射该端口：
ports: - "5678:5678"
- Node.js 同理：用
node --inspect=0.0.0.0:9229 app.js+"9229:9229" - Java（Spring Boot）需加 JVM 参数：
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:8000+"8000:8000" -
suspend=n表示启动不阻塞；若设为y，容器会卡住等调试器 attach，适合精准控制启动时序
launch.json 中每个服务对应一个独立配置
VSCode 不支持“一键 attach 所有容器”，你得为每个服务写一个 configurations 项，关键字段不能错：
-
type必须匹配语言（python/node/java） -
request固定为attach（不是launch） -
port填容器内监听端口（如5678），不是宿主机映射端口 -
host必须写localhost（即使容器跑在 WSL2 或远程 Docker Host 上，VSCode 默认走本地回环） - Python 需加
"justMyCode": false，否则debugpy内部代码可能干扰断点命中
示例（Python 服务）：
{
"name": "Python: Attach to Compose",
"type": "python",
"request": "attach",
"connect": {
"host": "localhost",
"port": 5678
},
"pathMappings": [
{
"localRoot": "${workspaceFolder}/src",
"remoteRoot": "/app/src"
}
],
"justMyCode": false
}日志查看别只信右键 View Logs
VSCode Docker 扩展调用的是 docker logs -f --tail=100，默认只加载最后 100 行，且不带时间戳。遇到启动失败或早期报错，很可能根本看不到关键信息：
- 先停掉 “Follow logs”，手动滚动到顶部；如果没内容，立刻切终端执行：
docker logs --since="5m" <container-name> - 中文乱码？不是 VSCode 编码问题，而是容器里
LANG没设对。检查docker exec -it <container> locale，若输出LANG=C，就得在Dockerfile里加ENV LANG=en_US.UTF-8 - 日志里没时间戳？在
docker-compose.yml的 service 下加logging配置，或改用docker logs -t手动查
Dev Containers 模式下调试路径映射容易失效
如果你用 .devcontainer/devcontainer.json + docker-compose.yml 启动整个开发环境，pathMappings 很可能不生效——因为 VSCode 实际连接的是 dev container 的内部 shell，而调试器 attach 的是 compose 启动的另一个容器。
- 确认
devcontainer.json中的service字段是否指向你要调试的那个服务名（不是dev容器本身） - 更稳妥的做法：把调试服务也写进
devcontainer.json的runArgs，统一由 Dev Container 管理生命周期，避免两个容器栈并存 - 挂载路径要双重校验：
volumes在 compose 里声明、pathMappings在launch.json里声明，两者localRoot和remoteRoot必须严格一致
真正卡住人的从来不是“怎么配”，而是容器内进程没监听、端口没透出、路径映射漏一级、或者日志根本没刷出来——这些地方一错，断点就永远灰着。
