VSCode通过Remote-Containers扩展实现容器化开发，代码在宿主机、编辑调试在容器内；需安装该扩展并验证Docker环境，配置devcontainer.json定义镜像、端口映射和扩展，调试需正确设置pathMappings，依赖应通过Dockerfile或postCreateCommand持久化。
vscode 本身不运行 docker 容器，但通过 remote - containers 扩展，它能直接在容器内启动完整开发环境——代码在宿主机，编辑、调试、终端全在容器里，这才是“容器化开发”的实际落地方式。
安装 Remote - Containers 扩展并验证 Docker 环境
这是唯一必需的扩展，其他如 Docker（官方）扩展只是辅助管理镜像/容器，不参与开发流程。安装后，VSCode 会自动检查 docker CLI 是否可用、当前用户是否在 docker 用户组（Linux/macOS）、Docker Desktop 是否运行（Windows/macOS）。
常见失败现象：
-
Failed to connect to Docker daemon：Docker 服务未启动，或当前用户无权限执行docker ps -
Command 'Dev Containers: Reopen in Container' not found：扩展未启用，或工作区根目录下缺少.devcontainer/devcontainer.json
验证命令：
docker info --format '{{.OSType}}/{{.Architecture}}' 应返回类似 linux/x86_64；再运行 docker run --rm hello-world确认基础运行正常。
用 devcontainer.json 定义容器开发环境
.devcontainer/devcontainer.json 是核心配置文件，它决定容器用什么镜像、挂载哪些目录、安装哪些工具、开放哪些端口。它不是 Docker Compose 替代品，也不启动多服务——只负责单个开发容器的初始化。
关键字段说明：
-
image或build：优先用已有镜像（如mcr.microsoft.com/vscode/devcontainers/python:3.11），避免每次重编；若需定制，用build指向Dockerfile -
mounts：慎用。默认已将工作区挂载为/workspaces/，额外挂载可能覆盖路径或引发权限问题 -
forwardPorts：填数字端口（如[3000, 8000]），VSCode 自动在本地映射并提供 “Open in Browser” 快捷按钮 -
customizations.vscode.extensions：列出容器内需预装的扩展 ID（如ms-python.python），避免每次重开手动安装
示例最小配置：
{
"image": "mcr.microsoft.com/vscode/devcontainers/python:3.11",
"forwardPorts": [8000],
"customizations": {
"vscode": {
"extensions": ["ms-python.python"]
}
}
}
调试 Python/Node.js 时容器内路径与宿主机不一致怎么办？
VSCode 调试器运行在容器内，但源码实际在宿主机。调试器靠 pathMappings 把容器路径映射回宿主机路径，否则断点不生效、堆栈显示错误路径。
必须显式配置（尤其使用非默认挂载路径时）：
拍客竞拍系统是一款免费竞拍网站建设软件，任何个人可以下载使用，但未经商业授权不能进行商业活动，程序源代码开源，任何个人和企业可以进行二次开发，但不能以出售和盈利为目的。安装方法，将www文件夹里面的所有文件上传至虚拟主机，在浏览器执行http://你的域名/install.php或者直接导入数据库文件执行。本次升级优化了一下内容1，程序和模板完美分离。2，优化了安装文件。3，后台增加模板切换功能。
- Python（
launch.json）："pathMappings": [ { "localRoot": "${workspaceFolder}", "remoteRoot": "/workspaces/${workspaceFolderBasename}" } ] - Node.js（
launch.json）："sourceMaps": true+ 同样的pathMappings - 如果
devcontainer.json中用了workspaceFolder自定义路径，remoteRoot必须严格匹配该值
典型症状：Breakpoint ignored because generated code not found 或断点显示为空心圆——90% 是 pathMappings 没对上。
容器重启后 pip install 的包不见了？
因为 pip install 默认装到容器临时文件系统，而 VSCode 的容器重建（如修改 devcontainer.json 后重开）会丢弃所有未持久化的变更。
正确做法只有两种：
- 把依赖写进
Dockerfile的RUN pip install指令，然后在devcontainer.json中用build字段引用它 - 或在
devcontainer.json的postCreateCommand中执行安装（如"postCreateCommand": "pip install -r requirements.txt"），该命令只在首次创建容器时运行一次
不要在容器终端里手动 pip install 后就以为万事大吉——下次 Reopen in Container 就得重来。
真正麻烦的从来不是“怎么启动容器”，而是环境一致性：CI 用的镜像、本地开发容器、生产部署镜像，三者 base 镜像和工具链版本稍有差异，就可能埋下隐性 bug。所以 devcontainer.json 里尽量别写死版本号，更别用 latest；每个团队成员打开项目时，应该得到完全相同的 shell、Python、node 版本——这才是容器开发最值得坚持的细节。
