docker容器开发优于宿主机装环境，因能保障环境一致性；vs code通过remote-containers扩展实现一键“reopen in container”；需正确配置devcontainer.json、网络访问（如host.docker.internal）及调试端口映射。
为什么直接在宿主机装环境不如用 Docker 容器开发
因为环境一致性最难靠人来维护。你本地跑通的 Python 3.9 + Django 4.2，换台机器可能卡在 psycopg2 编译失败；前端项目里 Node 版本、node_modules 二进制依赖、甚至时区设置都可能让 npm run dev 行为不一致。Docker 把运行时、依赖、配置全打包，VS Code 只需连进去，就像在另一台干净的机器上敲命令。
关键不是“能不能”，而是“要不要绕过容器做本地构建”——答案通常是：不要。尤其当你提交的 Dockerfile 和 CI 用的是同一套镜像时，开发即预演上线环境。
安装 Remote - Containers 扩展后怎么打开一个容器
别从空文件夹开始，也别手动 docker run 后再连。正确路径是：打开含 .devcontainer/devcontainer.json 的项目根目录 → 点右下角绿色按钮「Reopen in Container」→ 等 VS Code 拉镜像、建容器、装扩展、执行 postCreateCommand。
常见错误现象：
- 点按钮没反应？检查文件夹里有没有
.devcontainer目录和有效的devcontainer.json - 报错
The "docker" command was not found？确认 Docker Desktop 已启动，且 CLI 在系统 PATH 里（macOS/Linux 通常 ok，Windows 用户常漏掉 WSL2 集成） - 容器起来但终端卡在
Starting Dev Container？大概率是devcontainer.json里写的image名字拼错了，或私有 registry 没配docker login
推荐做法：优先用 image 字段指定基础镜像（如 mcr.microsoft.com/vscode/devcontainers/python:3.11），而不是 dockerfile —— 省去自己写 Dockerfile 的调试成本，尤其对新手。
如何让容器里访问宿主机服务（比如本地数据库）
容器默认在独立网络命名空间，localhost 指向自己，不是宿主机。想连宿主机上的 postgres 或 redis，必须用特殊地址：
- macOS / Windows：用
host.docker.internal（Docker Desktop 默认支持） - Linux：只能用宿主机真实 IP（查
ip route | grep default | awk '{print $3}'），或启动容器时加--add-host=host.docker.internal:host-gateway
注意：host.docker.internal 不是 Docker 标准，它只存在于 Docker Desktop 中。如果你用 podman 或裸 dockerd，这个域名会解析失败。别硬编码进应用配置，建议通过环境变量注入，例如在 devcontainer.json 里写：
"remoteEnv": {
"DB_HOST": "host.docker.internal"
}
这样既可读，又方便 CI 替换为真实服务地址。
容器里调试 Python/Node.js 时断点不生效怎么办
VS Code 调试器需要和容器内进程通信，常见断点失效是因为端口没暴露、路径映射不对、或调试器没启用。
- Python：确保
launch.json里"justMyCode": false（否则跳进第三方包就停不住），且容器里已装debugpy（Remote - Containers 扩展通常自动装，但自定义镜像得手动pip install debugpy） - Node.js：启动命令必须带
--inspect=0.0.0.0:9229（不能是127.0.0.1），并在devcontainer.json的forwardPorts列表加上9229 - 路径映射错误最隐蔽：如果容器里代码路径是
/workspace/myapp，但launch.json的"cwd"写成"./"，VS Code 就找不到源码对应关系。务必用绝对路径，或在devcontainer.json里设"workspaceFolder": "/workspace"
调试器连不上时，先在容器终端里跑 netstat -tuln | grep 9229 或 lsof -i :9229，确认进程真在监听，且绑定了 0.0.0.0。
路径映射和端口转发是两个独立开关，少一个都会让调试静默失败——这点最容易被忽略，因为没报错，只是断点变空心圆。
