vscode 连不上容器需先确认 .devcontainer/devcontainer.json 是否存在且路径正确；它必须位于项目根目录下的 .devcontainer/ 子目录中，否则 remote-containers 扩展无法识别配置并自动注入 vscode server。
VSCode 连不上容器？先确认 devcontainer.json 是否存在且路径正确
VSCode 本地编辑容器内代码，本质不是“直接打开”，而是通过 Remote-Containers 扩展建立 SSH-like 的代理连接。它依赖容器里有运行中的 VSCode Server（由扩展自动注入），而触发点就是项目根目录下的 .devcontainer/devcontainer.json。
常见错误现象：Dev Container Configuration not found；或者点击 “Reopen in Container” 后卡在 “Building image…” 却无日志。
-
devcontainer.json必须放在.devcontainer/子目录下，不能放在项目根或任意其他位置 - 如果容器已运行（比如用
docker run -d启的），但没挂载源码、没开放端口、没装git或curl，Remote-Containers就无法自动注入服务，会失败 - 推荐从空容器起步：用
Command Palette → Dev Containers: Add Development Container Configuration自动生成配置，比手写更稳
用 docker run 起的容器怎么接入 VSCode？别硬连，改用 devcontainer.json 重定义启动逻辑
手动 docker run -it -v $(pwd):/workspace ubuntu:22.04 起的容器，VSCode Remote-Containers 默认不认——它不解析你终端里的命令，只认 devcontainer.json 里声明的 image 或 Dockerfile。
真实使用场景：你已有调试中的容器，想快速编辑里面某段 Python 脚本，又不想重建环境。
- 不要试图用 “Attach to Running Container”（那个功能只支持极简调试，不挂载工作区、不启用完整语言服务）
- 在项目根建
.devcontainer/devcontainer.json，把image设为你的镜像名，如"ubuntu:22.04"，再加"mounts"显式绑定本地代码目录到容器内路径 - 必须指定
"workspaceFolder"，例如"/workspace"，否则 VSCode 不知道该把文件树映射到哪 - 如果原容器用了自定义 entrypoint 或非 bash shell，要在
devcontainer.json里补上"overrideCommand": false和"shutdownAction": "stopContainer"，避免连接后容器退出
devcontainer.json 里哪些字段最容易配错？重点关注 mounts、runArgs 和 features
配错一个字段，可能表现为：文件能打开但保存失败、终端进不去、Python 插件报 ModuleNotFoundError、甚至容器反复重启。
-
mounts是绝对路径，格式为"source": "/host/path", "target": "/container/path", "type": "bind"；Windows 用户注意source要用正斜杠，如"C:/project"，别用C:\project -
runArgs里加--privileged或--network=host可以，但加--rm会导致容器一断连就销毁，编辑中途丢失未提交修改 -
features是替代 Dockerfile 的快捷方式，比如装 Node.js：{"ghcr.io/devcontainers/features/node:1}；但它不会覆盖基础镜像里已有的同名二进制，旧版本仍可能残留，建议配"customizations.vscode.extensions"补齐语言插件
编辑保存后容器里没变化？检查文件系统挂载模式和 UID/GID 匹配
最隐蔽的问题：你在 VSCode 里改了 /workspace/main.py，进容器用 cat 看还是旧内容，或者保存时报 EPERM: operation not permitted。
- Linux/macOS 下默认挂载是
consistent模式，但某些 Docker Desktop 版本（尤其 macOS M1/M2）需显式设"mounts" → "options": ["cached"]或["delegated"]才实时同步 - 容器内进程 UID 和宿主机不一致时，VSCode Server 以 UID 1001 启动，但你挂载的代码目录属主是 UID 1000，导致权限拒绝；解决方法是在
devcontainer.json加"remoteUser": "root"，或提前在容器里usermod -u 1000 vscode - Windows 用户若用 WSL2 后端，确保 Docker Desktop 设置里启用了 “Use the WSL2 based engine”，否则挂载路径解析会出错
.devcontainer 目录放错位置、挂载选项没适配宿主机类型、UID 不匹配——都会让编辑体验退化成“看着像连上了，实际写不进、读不准”。这些细节没有报错提示，只表现为奇怪的延迟或静默失败。
