VSCode怎样使用Docker进行容器化开发【教程】

vscode 本身不运行 docker，但通过官方 Remote – Containers 扩展可实现在容器内开发、调试与运行；需先安装 Docker 引擎，卸载非必要 Docker 类插件，重启后状态栏显示连接标识。

VSCode 本身不运行 Docker，但通过 Remote - Containers 扩展可以真正实现“在容器里写代码、调试、运行”，不是简单调个 docker run 就完事——关键在于开发环境与运行环境的一致性是否闭环。

装对扩展：只认 Remote - Containers，别被其他 Docker 插件带偏

VSCode 市场里有十几个带 “Docker” 字样的扩展，但只有官方的 Remote - Containers（由 microsoft 发布）能让你把整个工作区打开进一个正在运行的容器中。它依赖本地已安装的 Docker 引擎，不自带 Docker，也不模拟容器。

• 必须先在系统上装好 Docker Desktop（macOS/windows）或 docker-ce（linux），且能正常执行 docker ps
• 卸载掉名字含 Docker Explorer、Docker Extension Pack 等纯管理类插件——它们只能看镜像、启停容器，不能接管开发会话
• 安装后重启 VSCode，右下角状态栏会出现 > 图标，悬停提示 “Reopen in Container”

.devcontainer/devcontainer.json 是核心配置，不是可选文件

这个 JSON 文件定义了容器怎么起、装什么、端口怎么映射、环境变量怎么设。没有它，VSCode 就不知道该用哪个镜像、要不要挂卷、是否自动安装扩展。它比 docker-compose.yml 更聚焦“开发态”而非“部署态”。

• image 或 build 二选一："image": "python:3.11-slim" 直接拉官方镜像；"build": { "dockerfile": "Dockerfile" } 则走自定义构建
• mounts 字段常被忽略：默认只有当前目录挂进容器的 /workspace，若项目依赖宿主机的 /etc/hosts 或本地数据库 socket，得手动加 "source": "/var/run/docker.sock", "target": "/var/run/docker.sock"
• forwardPorts 写的是容器内端口（如 8000），VSCode 会自动在宿主机开随机端口并转发，无需自己记 -p 8000:8000
• 别直接改 docker run 参数——所有配置都走 JSON 字段，比如要加 --cap-add=SYS_PTRACE，用 "runArgs": ["--cap-add=SYS_PTRACE"]

调试 Python/Node.js 时，容器内路径和宿主机路径必须对齐

VSCode 调试器运行在宿主机，但进程跑在容器里。断点能命中、变量能读取的前提是：调试器看到的文件路径（宿主机路径）和容器内解释器加载的路径（容器内路径）能一一映射。否则会显示 “Source code not available” 或跳过断点。

• 默认情况下，VSCode 把当前工作区路径（如 /Users/me/project）挂载为容器内的 /workspace，所以 launch.json 中的 "program" 必须写成 "${workspaceFolder}/main.py"，而不是硬编码绝对路径
• 如果用了 build + 自定义 Dockerfile，且在镜像里把代码 COPY 到了 /app，那必须同步改 devcontainer.json 的 workspaceFolder 字段为 "/app"，否则 VSCode 还以为代码在 /workspace
• Node.js 项目常见坑：npm install 在容器内执行后，node_modules 存在容器里，但宿主机没这份副本——这没问题；但如果你在宿主机执行 npm start，就会报错，因为根本没进容器

最易被忽略的一点：每次修改 devcontainer.json 后，必须点击右下角的 Reopen in Container（或按 Cmd/Ctrl+Shift+P → Dev Containers: Reopen in Container），而不是 Ctrl+S 保存就生效。VSCode 不会热重载容器配置，旧容器不会自动更新，改了等于白改。