code --install-extension 失败主因是 CLI 未注册、路径错误或离线环境依赖缺失；需先通过命令面板启用 code 命令、用绝对路径加引号、检查签名/架构/LSP 服务，并分批安装（≤10个/次）。
code --install-extension 命令根本跑不起来？先确认 CLI 是否注册
终端敲 code --version 没反应，不是插件问题，是 VSCode 根本没把命令行工具写入系统 PATH。Windows/macOS/Linux 都一样，必须手动启用一次。
打开任意一个已运行的 VSCode 窗口，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入并执行：Shell Command: Install 'code' command in PATH。执行完再开新终端验证。
- macOS/Linux 用户如果用 SSH 连服务器，需检查
~/.zshrc或~/.bashrc是否 source 了新增 PATH - Conda 环境下可能被隔离，建议在 base 环境中执行注册，或用
source ~/.bashrc刷新 - PowerShell 中若提示“无法加载文件”，说明执行策略限制，临时允许：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
路径写错一个字符就静默失败：绝对路径 + 引号是铁律
code --install-extension 不接受相对路径（如 ./python.vsix）、不识别当前目录（python.vsix 直接写名字会报 ENOENT），也不自动补全空格——它只认完整、可访问、未损坏的绝对路径。
- Linux/macOS 示例：
code --install-extension /home/alice/ext/ms-python.python-2026.6.0.vsix - Windows 推荐正斜杠写法（避免反斜杠转义）：
code --install-extension "C:/ext/vscode-eslint-2.4.0.vsix" - 路径含中文或空格时，双引号必须包裹整个路径，漏一个引号就截断
- 别用
cd到目录再执行——命令本身不依赖工作目录，靠的是你给的路径是否真实存在
离线装上却没功能？签名、架构、LSP 三座大山
安装成功 ≠ 插件可用。code --install-extension 只负责把文件扔进 ~/.vscode/extensions/，后续激活要过三关：
-
签名校验失败：非 Marketplace 下载的 .vsix（比如 GitHub Release）常无微软签名，VSCode 启动时直接卸载，日志里出现
Extension 'xxx' is not signed。加--allow-unverified参数绕过：code --install-extension python.vsix --allow-unverified -
架构不匹配：ARM Mac 上装了 x64 版本的插件，或 Windows 32 位装了 64 位二进制依赖，VSCode 不报错，但插件面板显示“已安装”，状态栏永远不出现语言服务提示。查
package.json里的engines.vscode和extensionKind，或用unzip -p xxx.vsix extension/package.json | grep -A2 "extensionKind\|engines" -
LSP 服务缺失：像
ms-python.python、volarjs.volar这类语言插件，.vsix 里只有前端逻辑，真正的 pyright-server 或 volar-server 是首次启用时联网下载的。离线环境必须提前在同版本 VSCode 上触发下载，再整份拷贝extensions/ms-python.python-xxx/目录过去
批量安装多个插件时，别堆在一个命令里硬扛
一条 code --install-extension 命令最多支持 10 个 --install-extension 参数，超了不会报错，而是从第 11 个起全部忽略。
正确做法是分批，例如：
code --install-extension a.vsix --install-extension b.vsix --install-extension c.vsix code --install-extension d.vsix --install-extension e.vsix
- 失败时会明确打印错误，比如：
Unable to install extension 'ms-python.python' as it is not compatible with VS Code '1.79.2'—— 这比 GUI 拖拽无声失败好排查得多 - 建议把所有 .vsix 放进同一目录，用
ls *.vsix | xargs -n 5 -I {} code --install-extension {}（Linux/macOS）控制每批 5 个，更稳妥 - Windows PowerShell 可用：
Get-ChildItem *.vsix | ForEach-Object { code --install-extension $_.FullName }，但注意单次仍不能超 10 个
真正卡住人的从来不是“怎么装”，而是装完发现没反应——这时候大概率不是命令写错了，是 package.json 里声明的 VSCode 最低版本比你本地高，或者 LSP 二进制根本没落地。离线部署前，务必用 unzip -p xxx.vsix extension/package.json 先扫一眼关键字段。
