必须先解决code命令不可用问题：终端运行code --version报command not found，说明VS Code CLI未注册到PATH，需通过图形界面执行“Shell Command: Install 'code' command in PATH”并新开终端验证。
code --install-extension 命令必须能调用才有效
如果终端输入 code --version 报错 command not found，说明 VS Code 的 CLI 工具没注册进系统 PATH。这不是插件问题，而是环境没配好。
Linux/macOS 下执行：code --install-extension 前必须确保已运行过 code --install-cli（VS Code 1.80+ 自带）或手动将 bin/code 软链到 /usr/local/bin；
Windows 用户需确认安装时勾选了「Add to PATH」，否则得用完整路径，比如："C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd" --install-extension
Conda 环境用户容易忽略这点：即使 code 在终端能运行，也可能因 shell 初始化顺序导致子 shell 失效，建议在激活环境后重新执行 source ~/.bashrc 或 conda init。
路径写错是安装静默失败的最常见原因
code --install-extension 不接受裸文件名，必须带路径前缀。只写 code --install-extension prettier-3.2.5.vsix 会报错或装到错误位置。
- 相对路径要加
./：code --install-extension ./prettier-3.2.5.vsix - 绝对路径更稳，尤其跨目录批量装：
code --install-extension /home/user/ext/ms-python.python-2024.10.0.vsix - Windows 上避免单反斜杠：
code --install-extension C:/ext/vscode-eslint-2.4.0.vsix比C:\ext\...更少出错
如果路径含空格，必须用引号包裹：code --install-extension "./my extension-1.0.0.vsix"，否则命令截断。
一次装多个 vsix 要重复写 --install-extension
VS Code 不支持通配符或目录批量安装，但允许一条命令串多个扩展：
code --install-extension ./a.vsix --install-extension ./b.vsix --install-extension ./c.vsix
注意：
• 最多支持 10 个 --install-extension 参数，超了会忽略后面项
• 每个参数必须独立，不能合并成 --install-extension a.vsix b.vsix
• 安装顺序不影响依赖加载，但若扩展 A 依赖扩展 B，B 必须先出现在命令中（VS Code 不自动解析依赖）
装完不生效？重点看 package.json 里的 engines.vscode
离线安装不会报兼容性错误，但插件根本不会启动——VS Code 启动时直接跳过它，控制台里也无提示。
解压 .vsix 文件（它本质是 zip），打开根目录下的 package.json，检查："engines": { "vscode": "^1.85.0" }
如果你的 VS Code 版本是 1.82.2，这个插件就永远不激活。解决办法只有两个：
• 升级 VS Code 到满足 ^1.85.0 的版本（即 ≥1.85.0 且 • 找低版本兼容的 .vsix（比如去 Marketplace 的「Version History」里下载 2023 年的老版）
别信“改 package.json 强行降级”，VS Code 会校验签名，篡改后会导致安装成功但启动时自动卸载。
