code --install-extension失败的根本原因是code命令未加入PATH；需运行which code验证，若无输出则手动将/usr/bin加入PATH并source配置文件。
直接用 code --install-extension 安装失败？先确认 VSCode 是否在 PATH 中
很多人在 Ubuntu 虚拟机里执行 code --install-extension xxx.vsix 报错 command not found，根本原因不是插件问题，而是 code 命令没加进系统路径。VSCode 官方 .deb 包默认不自动配置 PATH，尤其在非交互式终端（如 SSH 登录后）中更常见。
验证方式：在终端运行 which code。如果无输出，说明命令不可见。
- 临时解决：用绝对路径，比如
/usr/bin/code --install-extension /path/to/plugin.vsix - 永久解决：把
/usr/bin加入$PATH（检查~/.bashrc或/etc/environment），然后source ~/.bashrc - 注意：不要在安装命令前加
sudo，否则会提示You are trying to start Visual Studio Code as a super user，且插件实际装到 root 用户目录下，普通用户启动 VSCode 后看不到
.vsix 文件下载后无法安装？检查 engines.vscode 版本兼容性
离线安装失败最常被忽略的错误是版本不匹配——插件 package.json 里声明的 "engines": {"vscode": "^1.85.0"}，而你的 VSCode 是 1.79.2，VSCode 就会静默拒绝安装，连错误提示都不给。
解决方法不是“重试”，而是提前验证：
- 用
unzip -p plugin.vsix package.json | grep engines查看插件要求的最低 VSCode 版本 - 运行
code --version确认本地版本 - 若不兼容，要么升级 VSCode（需离线安装新 deb 包），要么降级插件——去 Marketplace 的
/versionhistory页面手动选旧版下载，例如https://marketplace.visualstudio.com/items/ms-python.python/versionhistory
强行修改 package.json 并重打包虽可行，但绕过签名验证后插件可能被禁用或功能异常，不建议在生产环境使用。
Ubuntu 虚拟机里拖放 .vsix 文件没反应？GUI 权限和文件系统限制要留意
在 VMware 或 VirtualBox 中，通过共享文件夹把 .vsix 拖进 VSCode 窗口，经常卡住或无响应。这不是 VSCode bug，而是 GUI 应用从挂载点（如 /mnt/hgfs）读取文件时受权限或 FUSE 层限制。
- 安全做法：先把
.vsix复制到本地路径，比如~/Downloads/，再拖放或用图形界面安装 - 检查挂载选项：运行
mount | grep hgfs，确认是否含uid=1000,gid=1000（对应当前用户），否则文件属主为 root，VSCode 无权读取 - 替代方案：用图形界面安装时，点击“… → Install from VSIX”，在弹窗中切换到“Other Locations → Computer”，避开挂载目录直选本地路径
批量部署多个插件时，code --list-extensions 导出的 ID 怎么对应到真实 .vsix 文件？
导出的 ms-python.python 这类 ID 看似简单，但实际下载时必须带版本号和平台标识，否则 vsce download 会失败或下错包。官方 API 不接受裸 ID 直接下载。
可靠做法分两步：
- 先用
curl -s "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2024.6.0/vspackage" --output python-2024.6.0.vsix—— URL 格式固定为publishers/{publisher}/vsextensions/{extension}/{version}/vspackage - 或改用工具：在有网机器上装
vsce（npm install -g vsce），再运行vsce download ms-python.python --version 2024.6.0 - 注意：Linux x64 插件和 Windows 版本名相同但内容不同，务必核对 Marketplace 页面右栏 “Download Extension” 按钮旁标注的平台（如 “Linux x64”），别直接下成 Windows 包
最后提醒一句：插件依赖不会自动解决。比如安装 ms-python.python 前，得先确保 ms-toolsai.jupyter 或 ms-vscode.cpptools（若用 C++）已就位，否则 Python 插件部分功能会灰掉——这得靠人工查 package.json 的 extensionDependencies 字段补全。
