Remote-Containers插件必须装在本地VS Code中，而非容器内；它依赖本地Docker环境（docker --version正常、DOCKER_HOST为默认路径）、正确命名的.devcontainer/devcontainer.json配置文件，且v0.312–v0.315版本需避开Docker Desktop≥4.28的兼容问题。
Remote-Containers 插件装不上，基本不是插件本身的问题，而是 VS Code 本地扩展系统没连上 Docker、远程容器环境没准备好，或者根本没走对安装路径。它只该装在本地，但很多人误以为要进容器里装，结果反复失败。
Remote-Containers 插件必须装在本地，且只能装一个
这个插件的作用是让本地 VS Code 控制容器内的开发流程（比如启动语言服务器、转发端口），它本身不进容器，也不依赖容器里有没有 Node.js 或 npm。装错位置是高频错误。
- 打开 Extensions 视图（
Ctrl+Shift+X），搜Remote - Containers，认准发布者是Microsoft - 别装
Remote Development扩展包——它包含三个子项，但 Remote-Containers 场景下只需要这一个单独扩展 - 如果已装了
Remote - SSH或Remote - WSL，不影响；但它们和 Remote-Containers 是相互独立的，不能互相替代 - 装完后不用重启 VS Code，但要确保本地能跑
docker --version且docker info不报错
装完插件，“Reopen in Container” 灰掉或点不动
这不是插件没生效，而是 VS Code 根本没找到有效的 .devcontainer/devcontainer.json 配置。它不识别放在项目根目录下的 devcontainer.json，也不接受大小写变体或错误路径。
- 手动创建目录：
mkdir -p .devcontainer，再把配置文件放进去 - 文件名必须是
devcontainer.json（全小写，带点开头），不能是DevContainer.json或.devcontainer.json - 配置里至少要有
"image"或"build"字段；如果用"build"，"dockerfile"路径必须存在且可读（例如"dockerfile": "./.devcontainer/Dockerfile"） - Windows 用户注意：
${localWorkspaceFolder}在挂载时若含空格或中文，会导致构建失败；建议项目路径用纯英文、无空格（如C:\dev\myproject）
点击后卡在 “Starting…” 或报 Failed to connect to Docker daemon
VS Code 插件调用的是本地 Docker CLI，但它对 DOCKER_HOST 环境变量更敏感了——v0.312+ 版本会校验这个变量，一旦被设成非默认值（比如 tcp:// 或 unix:///tmp/docker.sock），就会静默拒绝连接。
- 在终端运行
echo $DOCKER_HOST，如果输出非空，就重置：export DOCKER_HOST=unix:///var/run/docker.sock - Linux/WSL2 下确认当前用户在
docker组：groups输出里要有docker；没有就执行sudo usermod -aG docker $USER，然后newgrp docker -
ls -l /var/run/docker.sock应显示权限为srw-rw----；如果不是，说明 socket 文件权限异常，需修复 - macOS/Windows：确认 Docker Desktop 已启动，状态栏图标为绿色；WSL2 用户还要检查 Docker Desktop 设置中是否勾选了 “Use the WSL2 based engine”
插件装上了，但容器里终端打不开、Python 插件不识别语法
这是容器内权限没配对，不是插件问题。VS Code Server 进程需要以非 root 用户身份写入 /home/vscode/.vscode-server，而大多数基础镜像（如 python:3.11）默认只有 root。
- 在
devcontainer.json中必须声明"containerUser": "vscode" - 如果用自定义
Dockerfile，得显式创建用户：RUN useradd -m -u 1001 -G sudo vscode和USER vscode -
"remoteUser"是无效字段，它只影响你手动打开的终端，不解决 VS Code 自身的权限问题 - 微软官方 devcontainer 镜像（如
mcr.microsoft.com/vscode/devcontainers/python:3.11）已预建好vscode用户，但仍需在配置里写明"containerUser": "vscode"
最常被忽略的一点：Remote-Containers 插件 v0.312–v0.315 与 Docker Desktop ≥4.28 存在硬编码路径冲突，不是重装就能解决的。如果用了这些版本组合，直接降级到 v0.311.0 或升级到 v0.316.0 以上——旧版插件不会报错，但新 Docker 的权限模型会让它连不上 socket。
