remote-containers插件必须在宿主机离线安装，下载对应vscode版本的.vsix文件后通过图形界面或code --install-extension命令安装；容器内插件需用vscode-server命令行安装，且vscode-server须手动下载并注入镜像。
Remote-Containers插件本身怎么离线安装
你得先在宿主机上装好 Remote-Containers 插件，它才能启动容器里的开发环境。这个插件不能在容器里装——它运行在本地 VSCode 中，负责拉起容器、挂载配置、转发端口。所以离线安装必须发生在宿主机（即你打开 VSCode 的那台机器）上。
去官网下载对应版本的 vscode-docker 和 ms-vscode-remote.remote-containers 的 .vsix 文件，注意核对 VSCode 版本兼容性：engines.vscode 字段要 ≥ 你本地的 code --version 输出值。常见错误是下了新版插件，但宿主机 VSCode 还是 1.7x，直接报“incompatible”不给装。
安装方式就两种：
- 图形界面：扩展面板 → “…” → “从 VSIX 安装…” → 选中文件
- 命令行：
code --install-extension ms-vscode-remote.remote-containers-0.326.0.vsix（路径和文件名按实际改）
容器内插件怎么离线安装（不是 Remote-Containers）
容器里真正跑的是 vscode-server，它不认图形界面，也不连市场，所有插件都得提前打包进镜像或通过 CLI 安装。你不能在容器里点“安装”，得靠 code-server 提供的命令行接口。
关键点有三个：
-
vscode-server必须和宿主机 VSCode 版本严格匹配，否则插件安装会失败（比如提示“server version mismatch”） - 插件要以
.vsix形式 COPY 进镜像，路径建议统一放在/root/.vscode-server/extensions/或挂载为 volume - 安装命令不是
code --install-extension，而是容器内执行：/root/.vscode-server/bin/<hash>/bin/code-server --install-extension /path/to/plugin.vsix</hash>，其中<hash></hash>是vscode-server启动后生成的实际目录名（可通过ls ~/.vscode-server/bin/查）
vscode-server 怎么离线获取并放进镜像
这是整个流程最常卡住的一环。VSCode 不提供公开的 vscode-server 下载地址，它默认从 update.code.visualstudio.com 拉取。离线环境下必须手动下载对应哈希值的压缩包。
正确做法是：在一台能联网、且 VSCode 版本与目标环境一致的机器上，启动一次 Remote-Containers，让它自动下载 vscode-server；然后去宿主机的 ~/.vscode-server/bin/ 找到那个带长哈希的目录，把整个目录打包（tar -czf vscode-server-<hash>.tar.gz <hash></hash></hash>）传进内网。
在 Dockerfile 中这样用：
COPY vscode-server-834e1d59a28851b349c3e3239863e22325652525.tar.gz /tmp/ RUN tar -xzf /tmp/vscode-server-834e1d59a28851b349c3e3239863e22325652525.tar.gz -C /root/.vscode-server/bin/ \ && rm /tmp/vscode-server-834e1d59a28851b349c3e3239863e22325652525.tar.gz
漏掉这一步，容器起来后会卡在“Installing VS Code Server”，日志里反复报 Failed to fetch。
为什么装了插件还是不生效
容器内插件不生效，八成是路径或权限问题。常见坑包括：
- 插件
.vsix被 COPY 到了/root/.vscode-server/extensions/，但没解压——.vsix是 ZIP 包，必须用code-server --install-extension解压并注册，不能直接放进去 - 用了非 root 用户启动容器，但插件路径写死在
/root/下，导致vscode-server找不到 - 插件依赖其他插件（比如 Python 插件依赖 Pylance），只装主插件，没装依赖，结果功能残缺，调试器根本启动不了
- Dockerfile 里用了
USER dev，但没同步修改CODE_SERVER_INSTALL_EXTENSIONS环境变量指向用户家目录下的 extensions 路径
最稳妥的做法是：所有插件都在构建阶段用 code-server --install-extension 安装，并确保该命令执行时的用户和最终运行 vscode-server 的用户一致。
