Dev Containers中装.vsix必须在容器内执行code --install-extension，因插件需部署到~/.vscode-server/extensions/且受容器环境（签名、版本、架构）约束，宿主机拖放无效。
Dev Containers里装.vsix，别直接拖进VSCode主窗口
在 Dev Container 中，VSCode 的 GUI 界面运行在宿主机，但插件实际要部署到容器内的 ~/.vscode-server/extensions/ 目录才生效。直接把 .vsix 文件拖进宿主机 VSCode 窗口，只会尝试安装到宿主机的用户扩展目录（~/.vscode/extensions/），对容器内环境完全无效——这是最常踩的坑。
正确路径是：先让 .vsix 进入容器文件系统，再用容器内可用的 code CLI 安装。
- 把
.vsix文件复制进容器：可通过 VSCode 命令面板执行Dev Containers: Reopen in Container后，在远程资源管理器中右键容器 →Open Folder in Container，再拖入.vsix；或用docker cp命令手动拷贝 - 确保容器内已安装
codeCLI：多数官方 Dev Container 镜像已预装；若无，需在Dockerfile或devcontainer.json中添加安装步骤（如 Debian 系镜像：apt-get update && apt-get install -y curl && curl -fsSL https://aka.ms/install-vscode-server-stable | sh） - 在容器终端中执行：
code --install-extension /path/to/your-extension-1.2.3.vsix（路径必须是容器内绝对路径）
devcontainer.json 里预装插件，优先用 customizations.vscode.extensions
硬编码 .vsix 路径到配置里不现实，因为构建时文件不一定存在、路径也不便分发。真正可复现的方式是声明插件 ID，由 VSCode 自动拉取——但这依赖容器能联网。若网络受限，就得换思路：
- 把
.vsix放进项目根目录（如.devcontainer/ext/），并在devcontainer.json的postCreateCommand中执行安装命令：code --install-extension /workspaces/my-project/.devcontainer/ext/ms-python.python-2026.6.0.vsix
- 注意：该命令只在首次创建容器时运行；后续重启容器不会重跑，所以版本变更需重建容器或手动更新
- 若插件有原生二进制依赖（如
ms-vscode-remote.remote-ssh），确认.vsix是为容器架构打包的（例如linux-x64），跨平台拷贝的 Windows 版本会报Unsupported platform
安装后插件不启用？检查容器内 extensions.experimental.affinity
Dev Container 场景下，未签名的 .vsix 插件默认被拦截，且不会弹窗提示——因为容器内无 GUI 权限。现象是：插件显示“已安装”，但在扩展列表里状态为禁用，日志里出现 This extension is not signed。
- 解决办法是在容器内用户级设置中关闭校验：
~/.vscode-server/data/Machine/settings.json（不是宿主机的User/settings.json） - 添加配置项：
"extensions.experimental.affinity": {}或更稳妥地设为"extensions.ignoreRecommendations": true
- 修改后需彻底重启容器（不只是重载窗口）：命令面板 →
Dev Containers: Rebuild and Reopen in Container - 验证是否生效：在容器终端运行
code --list-extensions，应看到插件 ID 列出；再打开命令面板搜插件功能是否可用
离线场景下，package.json 的 engines.vscode 必须匹配容器内 VS Code Server 版本
Dev Container 使用的是独立的 VS Code Server，其版本不一定和宿主机 VSCode 一致。装高版本 API 要求的插件（比如 "engines": {"vscode": "^1.95.0"}），而容器里跑的是 1.92.2，结果就是静默禁用——连错误提示都不给。
- 查容器内真实版本：
code --version或看~/.vscode-server/bin/下的哈希目录名（对应 commit id，可查 release 日志反推版本） - 下载
.vsix时，务必去插件 Version History 页面核对兼容性，选标有 “VS Code >= 1.92.x” 的版本 - 别信
vsixget --latest自动选的“最新版”，它按宿主机市场逻辑选，可能忽略容器侧约束 - 一个简单验证法：解压
.vsix，打开package.json，确认engines.vscode满足容器版本（例如^1.92.0兼容1.92.2，但不兼容1.91.4）
