Dev Containers插件未生效因路径、文件名或配置错误：须确保根目录下存在.devcontainer/devcontainer.json，含"image"或"build"字段；远程环境需本地Docker；权限问题应将项目存于WSL2文件系统。
Dev Containers插件没生效，.devcontainer/devcontainer.json 不被识别？
VSCode 只有在工作区根目录下存在 .devcontainer/devcontainer.json（或 .devcontainer.json）时才会主动提示“Reopen in Container”。常见错误是路径放错：比如放在子目录里、文件名拼错成 devcontainer.yaml 或漏了点号前缀。
实操建议：
- 确认路径是
.devcontainer/devcontainer.json，不是devcontainer.json（少一个点）或.devcontainer.json（没建目录） - 文件必须至少包含
"image"或"build"字段，空文件或只有注释不会触发识别 - 如果用远程 SSH 或 WSL 打开工作区，Dev Containers 默认不启用——需先确保本地已安装 Docker 且 VSCode 连接的是本地窗口
devcontainer.json 中 image 和 build 怎么选？
image 直接拉取现成镜像，快但定制性弱；build 指向 Dockerfile，适合加装工具链、配置权限或复用已有构建逻辑。选错会导致环境缺失依赖或启动失败。
实操建议：
- 快速验证用
"image": "mcr.microsoft.com/vscode/devcontainers/python:3.11"，微软官方镜像更新勤、基础工具全 - 需要
git-lfs、jq或私有 CA 证书？改用"build": { "dockerfile": "Dockerfile" }，并在Dockerfile里RUN apt-get update && apt-get install -y jq - 避免在
build里写COPY . /workspace——Dev Containers 默认会把工作区挂载到/workspace，重复拷贝反而覆盖本地修改
容器启动后终端里没有 conda 或 node，PATH 不生效？
Dev Containers 启动时只读取 shell 的 login 配置（如 /bin/bash --login），而很多环境变量（尤其 conda 初始化脚本）依赖交互式 shell 或手动 source，非 login 模式下不会执行。
实操建议：
- 在
devcontainer.json中加"settings": { "terminal.integrated.defaultProfile.linux": "bash" }并确保"features"或Dockerfile已正确初始化 conda（例如运行conda init bash） - 更可靠的做法：在
devcontainer.json里用"postCreateCommand"自动 source，例如"postCreateCommand": "source /opt/conda/etc/profile.d/conda.sh && conda activate base" - Node.js 版本管理（如 nvm）同理——
postCreateCommand必须显式source ~/.nvm/nvm.sh，否则node命令找不到
Windows 上挂载项目目录后文件权限变 000，Git 提交报错？
WSL2 + Docker Desktop 组合下，Windows 文件系统挂载进 Linux 容器默认无执行权限，chmod 失效，git status 显示大量权限变更，甚至 Python 脚本无法运行。
实操建议：
- 在
devcontainer.json中添加"runArgs": ["--privileged"]无效，真正要改的是 Docker Desktop 设置：打开 Settings → Resources → WSL Integration → 启用对应发行版，并勾选 “Enable integration with my default WSL distro” - 更治本的方案：把代码放在 WSL2 的 Linux 文件系统内（如
~/projects/myapp），而非/mnt/c/Users/xxx/...路径 - 若必须用 Windows 路径，可在
devcontainer.json加"mounts": ["source=c:/your/project,target=/workspace,type=bind,consistency=cached"]，但仅缓解，不解决根本权限映射问题
Dev Containers 的核心约束其实就一条：它不接管你的宿主系统，只接管容器内环境。所有和宿主机的交互——路径挂载、端口转发、GUI 工具调用——都依赖 Docker 运行时与 VSCode 宿主进程之间的协作精度。稍有不匹配，比如 WSL 版本不对、Docker Desktop 服务未启动、或 devcontainer.json 里一个逗号写错，整个流程就会静默卡住，连错误提示都不给。
