VS Code Dev Containers 怎样区分本地与容器扩展

在 VS Code 里打开 Dev Container 后，扩展并不是“安装一次、所有窗口都能直接使用”。主题、快捷键这类只影响界面的扩展通常留在本地 UI 侧；需要读取容器文件、调用容器里的语言服务或执行容器命令的扩展，则应安装到当前容器窗口。最直观的判断方法，是打开扩展视图，看它位于 Local - Installed 还是 Dev Container: 项目名 分组。

官方地址：https://code.visualstudio.com/docs/devcontainers/containers

本文只处理“扩展到底装在哪里、为什么容器里不生效”这一条线。示意图是依据官方操作路径制作的原创界面说明图，不是 VS Code 截图，也不代表本机已经执行过图中状态。

先确认当前窗口确实进入了 Dev Container

先观察 VS Code 窗口左下角的远程连接指示器，或打开命令面板运行 Dev Containers: Reopen in Container。连接成功后，窗口的工作区上下文已经切换到容器，文件、终端和大多数工作区扩展会由容器侧的 VS Code Server 处理。

如果你仍在普通本地窗口里，只会看到本地扩展分组；这时即使把扩展“装好了”，也不能据此判断容器窗口是否拥有同一个扩展。先切换到容器窗口，再进行下面的安装位置判断。

在扩展视图区分本地和容器位置

打开侧栏的 Extensions，或者运行 Extensions: Focus on Extensions View。在已连接容器的窗口中，已安装扩展会按运行位置分组，常见的两个观察点是 Local - Installed 与 Dev Container: 项目名。前者表示扩展运行在本地 UI 侧，后者表示扩展安装在当前容器的工作区侧。

判断时不要只看扩展是否出现在搜索结果里，而要看扩展详情页显示的安装目标。主题、图标和部分 UI 个性化扩展只需要留在 Local - Installed；Go、Python、TypeScript、C/C++ 等需要访问容器内源码或运行时的扩展，通常应出现在容器分组中。最终位置仍由扩展支持的运行方式和当前远程窗口决定。

把需要容器运行时的扩展装进容器

在容器窗口的 Extensions 搜索目标扩展，打开详情页后，使用安装按钮旁的目标选择或云端安装入口，选择 Install in Dev Container: 项目名。安装完成后，扩展会在容器侧重新加载；如果详情页仍显示本地安装按钮，先确认当前窗口左下角的远程连接状态没有丢失。

这一步解决的是“扩展安装到了哪里”，不是“扩展是否一定兼容容器”。如果扩展依赖本机 GUI、宿主机路径或本机专用运行时，即使安装到容器，也可能只能保留部分功能。此时应先看扩展文档对 Remote Development 的支持说明，不要通过复制本地扩展目录来绕过安装流程。

用 devcontainer.json 固化容器扩展

只在当前容器手动安装，容器重建后可能需要再次处理。团队项目更适合把扩展 ID 写进项目的 .devcontainer/devcontainer.json。下面的示例保持严格 JSON：image 指定基础镜像，customizations.vscode.extensions 列出创建容器时要安装到容器侧的扩展。

{
  "image": "mcr.microsoft.com/devcontainers/typescript-node",
  "customizations": {
    "vscode": {
      "extensions": [
        "dbaeumer.vscode-eslint",
        "streetsidesoftware.code-spell-checker"
      ]
    }
  }
}

配置文件本身不包含注释，所以字段含义放在代码块外说明：扩展数组保存市场扩展 ID，VS Code 读取配置后会在容器创建或重建时准备这些扩展。改完配置后运行 Dev Containers: Rebuild Container，再回到 Extensions 观察容器分组是否出现对应条目。

扩展显示已安装但容器里仍不生效

按下面顺序排查，能够把安装位置、容器状态和扩展能力区分开：

1. 看窗口：确认当前标题和左下角指示器对应 Dev Container，而不是另一个本地窗口。
2. 看分组：在 Extensions 里确认目标扩展出现在 Dev Container: 项目名，而不是只有 Local - Installed。
3. 看配置：如果扩展来自 devcontainer.json，确认扩展 ID 位于 customizations.vscode.extensions 数组中，且 JSON 逗号和括号正确。
4. 看重建：修改配置后执行 Dev Containers: Rebuild Container；只关闭并重新打开窗口，不一定会重新读取镜像和扩展配置。
5. 看依赖：若位置正确仍无语言服务或命令，检查扩展是否需要容器内的编译器、运行时或额外依赖。

不要把“本地能看到扩展”理解成“容器已经安装”。VS Code 的远程开发模型会把本地 UI 扩展主机和远程工作区扩展主机分开；扩展详情页里的分组和运行位置，才是当前窗口的有效线索。

操作完成后的确认清单

• 左下角远程指示器明确显示当前开发容器。
• Extensions 视图能区分 Local - Installed 和容器分组。
• 需要访问容器代码或运行时的扩展出现在容器分组。
• 团队必需扩展已写入 customizations.vscode.extensions。
• 重建容器后，扩展仍能在容器分组中找到。

相关问题

主题扩展需要安装到 Dev Container 吗？

通常不需要。主题和其他主要影响本地 UI 的扩展一般运行在本地侧；是否需要远程安装，仍以扩展的运行位置说明为准。

为什么本地安装的扩展在容器里不能用？

本地安装只说明本地 UI 扩展主机拥有它。容器工作区需要的扩展应安装到当前容器，或写入 devcontainer.json 后重建容器。

修改 devcontainer.json 后只重载窗口可以吗？

如果修改的是容器扩展列表，优先执行 Dev Containers: Rebuild Container，这样能让配置重新参与容器创建过程；仅重载窗口适合处理已安装扩展的界面刷新，不等同于重建。