vs code容器内插件必须显式声明在devcontainer.json中，因容器运行独立vs code server实例，本地插件安装与更新对其无效；需通过customizations.vscode.extensions精确指定marketplace id及版本，并执行rebuild container触发重装。
Dev Container环境中的VSCode插件更新，不能依赖本地插件自动同步——必须显式声明在 devcontainer.json 中，否则每次重建容器都会丢失。
为什么本地安装的插件不会进入容器？
VS Code 的 Remote - Containers 扩展运行时，容器内是独立的 VS Code Server 实例，与本地客户端完全隔离。你在本地 UI 界面里点“更新插件”，只更新了宿主机上的插件缓存，对容器内无效。
常见错误现象包括：
- 容器重启后，
ms-python.python回退到旧版，debugpy版本不匹配导致断点失效 - 团队成员打开同一仓库，有人能用 Copilot Next 补全，有人提示“extension not found”
-
prettier-vscode在容器 terminal 里格式化失败，报错Cannot find module 'prettier'
如何在 devcontainer.json 中正确声明插件？
使用 customizations.vscode.extensions 字段，填入 Marketplace ID（不是插件名），支持语义化版本控制（需配合 vscode-dev-containers 插件 v0.270+）：
{
"image": "mcr.microsoft.com/devcontainers/python:3.12",
"customizations": {
"vscode": {
"extensions": [
"ms-python.python@2024.12.0",
"ms-python.debugpy@2024.10.0",
"esbenp.prettier-vscode@10.1.0"
]
}
}
}
关键细节：
- 版本号必须精确匹配 Marketplace 上发布的版本 tag（查法：
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ “Version History”） - 不要写
latest或通配符 —— Dev Containers 不解析它们，会静默忽略 - 如果插件依赖特定 VS Code 内核版本（如 Copilot Next 要求 VS Code 1.92+），需同步检查
remote.containers.defaultContainerOS和基础镜像兼容性
更新插件时容易忽略的三个动作
仅改 devcontainer.json 并不够，必须触发完整重载流程：
- 执行
Dev Containers: Rebuild Container（不是Reopen in Container），确保postCreateCommand和扩展安装流程重跑 - 检查容器终端输出里是否出现
Installing extensions...及对应成功日志，失败时通常卡在 network timeout 或私有 registry 认证缺失 - 打开命令面板（
Ctrl+Shift+P），运行Developer: Show Running Extensions，确认列表中显示的是容器内加载的插件（Host 列为Dev Container）
最常被跳过的环节是验证插件实际生效位置——很多人看到本地插件列表里有勾选就以为成功了，但真正起作用的是容器内的那一份，它只认 devcontainer.json 里写的版本和安装时机。
