VSCode离线安装报“Unable to install extension”主因是文件不完整、版本不兼容或依赖未满足；需确保.vsix原始有效、engines.vscode匹配、并按extensionDependencies顺序安装。
离线安装插件时，VSCode 为什么报 Unable to install extension？
因为 VSCode 默认只认 .vsix 文件，且要求文件完整、签名未损坏、与当前版本兼容。直接双击或拖入安装失败，常见原因有：插件依赖未满足（比如 ms-python.python 依赖 ms-toolsai.jupyter）、VSCode 版本太旧不支持插件的 engines.vscode 范围、或文件下载不完整导致校验失败。
怎么用脚本批量安装本地 .vsix 文件？
核心是调用 VSCode 的命令行接口 code --install-extension，它支持绝对路径和通配符，但不支持相对路径中的 ~ 或未展开的变量。实操建议如下：
- 把所有
.vsix文件统一放在一个空目录下（如/opt/vscode-extensions），避免路径含空格或中文 - 在终端中运行：
code --install-extension /opt/vscode-extensions/*.vsix --force
（--force可跳过已安装提示，但不会覆盖启用状态） - 如果插件有依赖关系，先手动查
package.json中的extensionDependencies字段，按顺序安装（例如先装ms-toolsai.jupyter-2024.2.0.vsix，再装ms-python.python-2024.8.0.vsix） - Windows 用户注意：PowerShell 不支持
*展开，改用Get-ChildItem *.vsix | ForEach-Object { code --install-extension $_.FullName }
code 命令不可用？怎么修复 PATH 并确保脚本可移植
VSCode 安装时未必自动把 code 加入系统 PATH，尤其 macOS 和 Linux 手动解压版。必须先确认命令可用，否则脚本会静默失败：
- macOS：运行
which code，若无输出，执行sudo /Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code --install-server（新版推荐用菜单「Shell Command: Install 'code' command in PATH」） - Linux：检查
/usr/bin/code是否存在；若用.tar.gz解压安装，需手动软链：sudo ln -s /path/to/VSCode-linux-x64/bin/code /usr/local/bin/code - 脚本开头加校验：
if ! command -v code &> /dev/null; then echo "error: 'code' not in PATH"; exit 1; fi
为什么装完插件不生效？关键忽略点
离线安装只是把文件复制到 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\（Windows），但 VSCode 不会自动激活——特别是当插件需要重启窗口、或被工作区禁用、或与已启用插件冲突时：
- 必须关闭所有 VSCode 窗口后重开，否则新插件处于“已安装但未加载”状态
- 检查
settings.json是否含"extensions.ignoreRecommendations": true，这会导致插件不自动启用 - 某些插件（如
esbenp.prettier-vscode）需配置"editor.formatOnSave": true才可见效果，光安装没用 - 企业环境常禁用远程扩展主机（
remote.extensionKind），此时即使装了 SSH 或 WSL 插件，也只会显示“已安装（禁用）”
