必须满足容器进程暴露调试端口且本地调试器能网络访问；Node.js需用--inspect=0.0.0.0:9229绑定所有接口，docker映射端口为9229:9229，launch.json中address和remoteRoot须严格匹配网络拓扑与路径。
容器环境里 VS Code 能断点调试，但必须满足两个前提：容器内进程暴露了调试端口，且本地调试器能通过网络访问该端口。光靠 docker run 默认参数或没配 launch.json 的 attach 模式，90% 会失败。
Node.js 容器必须启用 --inspect 并绑定 0.0.0.0
常见错误是只写 --inspect 或 --inspect=9229，这会让 Node 进程只监听 127.0.0.1:9229，而 Docker 容器的 localhost 和宿主机不是同一个网络命名空间，VS Code 就连不上。
- 正确做法是显式绑定到所有接口：
node --inspect=0.0.0.0:9229 src/index.js - 同时在
docker-compose.yml中映射端口：ports: ["9229:9229"]（注意不是9229单个数字） - 如果用
docker run，别漏掉-p 9229:9229和--network host（仅限 Linux 测试用，生产慎用）
launch.json 的 attach 配置必须匹配容器网络拓扑
VS Code 不知道你是在本机跑容器、用 Docker Desktop、还是连远程 Kubernetes 集群，address 和 remoteRoot 填错一个，断点就永远灰色。
-
address应该填宿主机可访问的地址：本地 Docker Desktop 填"localhost"；Linux 直连 Docker 引擎可填"172.17.0.1"（Docker 网桥网关）；K8s Pod 则需用kubectl port-forward中转后填"localhost" -
remoteRoot必须和容器内代码实际路径一致，比如 Dockerfile 里COPY . /app，这里就得写"/app"，不能写"/src"或留空 -
localRoot要对应你本地打开的工作区路径，推荐用"${workspaceFolder}"，避免硬编码
Remote - Containers 扩展比手动 attach 更可靠
手动配置 launch.json + docker-compose.yml 容易漏掉卷挂载、环境变量或调试器路径，尤其当项目有构建步骤时。Remote - Containers 本质是把整个开发环境“搬进容器”，调试器直接在容器里运行，绕过了网络穿透问题。
- 只需在项目根目录建
.devcontainer/devcontainer.json，指定基础镜像和forwardPorts - VS Code 自动挂载源码、安装扩展、启动终端，
F5启动的就是容器内原生调试器 - 断点命中率高，变量查看、调用栈、表达式求值都无额外适配成本
- 缺点是无法调试容器启动前的初始化逻辑（如 entrypoint 脚本），这类场景仍需传统 attach
最常被忽略的是容器内调试端口是否真在监听——别只信日志里 “Debugger listening on…”，进容器执行 netstat -tuln | grep 9229 看一眼更稳妥。网络层不通，再对的 launch.json 也白搭。
