code命令找不到需先启用cli功能：在vs code中通过ctrl+shift+p运行“shell command: install 'code' command in path”，重启终端后验证code --version；离线安装报invalid_signature须加--allow-unverified参数；.vsix兼容性取决于package.json中engines.vscode字段，须与本地vs code版本匹配。
code命令找不到？先确认CLI是否可用
很多人执行 code --install-extension xxx.vsix 时直接报错 command not found，根本不是网络或文件问题，而是 VS Code 的命令行工具没启用。这不是 PATH 配置问题，而是功能开关没打开。
- 在 VS Code 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择
Shell Command: Install 'code' command in PATH，回车执行 - 重启终端（不是 VS Code），再运行
code --version验证是否输出版本号
注意：Conda 环境下可能需额外执行 source ~/.bashrc 或 source ~/.zshrc 才能生效。
安装失败报 INVALID_SIGNATURE？加 --allow-unverified
离线环境无法连接微软证书服务器校验签名，code --install-extension 默认会拒绝未验证签名的 .vsix 文件，错误信息就是 INVALID_SIGNATURE —— 这不是文件损坏，是安全策略拦截。
- 必须显式加参数绕过：
code --install-extension python.vsix --allow-unverified - 该参数仅影响签名验证，不降低扩展本身安全性
- 企业策略禁用非市场扩展时，此参数无效，需联系管理员配置信任源
下载的 .vsix 兼容吗？看 package.json 的 engines.vscode
不是所有 .vsix 都能在你当前 VS Code 版本上运行。常见报错是安装成功但插件不激活、无图标、命令不可用，根源常在版本不匹配。
- 用
unzip -p xxx.vsix package.json | grep engines快速查看要求："vscode": "^1.85.0" - 运行
code --version对比，若本地是1.84.2，则该扩展不兼容 - 官网插件页的 “Requirements” 栏明确写了最低支持版本，务必核对
- 旧版插件（如 Python 3.7 适配版）需手动找历史版本号，拼 URL 下载，不能只下最新版
安装后不生效？别跳过重启和依赖检查
VS Code 不会自动重载已安装的扩展，尤其当扩展有 activationEvents（比如 onLanguage:python）时，不重启或不触发对应事件，功能就“看不见”。
- 安装后必须重启 VS Code，或至少关闭再打开工作区
- 某些扩展（如 Pylance、Jupyter）依赖其他扩展，
package.json里的extensionDependencies字段列出了它们 - 在 Extensions 面板搜索依赖项名称，确保都已安装并启用
- 命令面板输入
Developer: Toggle Developer Tools，看 Console 是否有Activating extension...后跟错误
真正卡住的地方往往不是下载或安装步骤，而是版本兼容性、签名验证、依赖缺失这三点——它们不报明显错误，但让插件静默失效。
