dev containers 中插件独立安装于容器内，由 devcontainer.json 的 extensions 字段指定完整 id（如 ms-python.python），大小写敏感且不可省略发布者；安装异步进行，失败不中断启动；需复用本地插件时须通过 mounts 和 --extensions-dir 显式挂载。
Dev Containers 中的插件是装在容器里，不是本地
很多人误以为 Remote - Containers 会复用本地已安装的插件，其实不然：每次“Reopen in Container”后，VSCode 会根据 .devcontainer/devcontainer.json 中的 customizations.vscode.extensions 列表，在容器内**独立安装指定插件**，和宿主机的 ~/.vscode/extensions 完全无关。
这意味着：
- 本地装了
ms-python.python，容器里没声明，就看不到 Python 语法高亮或调试按钮 - 容器里装了
llvm-vs-code-extensions.vscode-clangd，但本地没装，也不影响容器内正常工作 - 插件版本由配置中声明的 ID 和远程市场快照决定，不是本地缓存版本
.devcontainer.json 里 extensions 字段必须写全名，不能省略发布者
customizations.vscode.extensions 的值是一组完整插件 ID 字符串，格式为 publisher.id，比如 golang.go 或 ms-python.python。漏掉发布者（如只写 go 或 python）会导致插件安装失败，且错误不明显——VSCode 只会在 Dev Container 启动日志里输出 Extension 'xxx' not found。
常见易错点：
- 把
dbaeumer.vscode-eslint写成vscode-eslint→ 找不到 - 把
ms-vscode.cpptools写成cpptools→ 安装跳过，C++ 调试功能缺失 - 大小写敏感：
ms-python.Python（错误） vsms-python.python（正确）
插件安装发生在容器启动后、首次 attach 前，失败不会中断流程
VSCode 在容器启动并完成初始化 shell 后，才批量安装 extensions 列表中的插件。这个过程是异步的，即使某个插件下载超时或签名验证失败，VSCode 仍会继续打开工作区——你可能已经能编辑代码，但某些功能（如 clangd 补全、ESLint 校验）始终不生效。
排查建议：
- 打开命令面板，执行
Developer: Toggle Developer Tools，切换到 Console 标签页，搜索extensionGallery或install - 查看容器终端输出：执行
tail -f /var/log/vscode-remote-containers.log（路径因基础镜像而异） - 进容器手动检查：
ls -l /root/.vscode-server/extensions/（Linux 容器 root 用户路径）
需要本地插件配合时，得靠 --extensions-dir 显式挂载
极少数场景下，你确实需要让容器复用本地插件（例如自研插件未上架市场、或 CI 环境预置了定制版扩展），这时不能依赖 extensions 配置，而要通过挂载方式注入：
在 .devcontainer/devcontainer.json 中添加：
"mounts": [
"source=${localEnv:HOME}/.vscode/extensions,target=/root/.vscode-server/extensions,external=true"
],
"runArgs": ["--extensions-dir", "/root/.vscode-server/extensions"]
注意：
-
source路径需匹配你本地插件实际位置（Windows 是%USERPROFILE%\.vscode\extensions） -
target必须与容器内 VS Code Server 实际读取路径一致（不同镜像用户身份不同，/root或/home/vscode需确认） - 该方式绕过 marketplace 校验，插件兼容性风险需自行承担
真正容易被忽略的是：插件的激活时机依赖于 package.json 中的 activationEvents，而容器内没有完整的 VSCode UI 生命周期，部分插件（尤其是监听 onStartupFinished 的）可能根本不会激活——这种问题只能靠日志和插件文档交叉验证。
