先确认code命令未注册进PATH：Linux/macOS运行which code、Windows运行where code，无输出即未注册；临时用绝对路径安装，永久修复需在VSCode中执行Shell Command: Install 'code' command in PATH并重启终端。
code --install-extension 报 command not found 怎么办
这不是网络问题，是 VSCode 的 CLI 工具根本没注册进系统 PATH。Linux/macOS 上运行 which code 无输出、Windows 上运行 where code 找不到，就说明命令不可见。
- 临时解决：用绝对路径执行，比如
/usr/bin/code --install-extension /path/to/xxx.vsix（Linux）或/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /path/to/xxx.vsix（macOS） - 永久修复：在 VSCode 中按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行，再重启终端 - 别加
sudo：否则插件会装到 root 用户目录，普通用户启动 VSCode 后看不到
拖拽 .vsix 后卡在 “Installing…” 或没反应
图形界面安装依赖后台网络请求做签名验证和解压调度，断网时它不报错，只挂起或丢弃操作。
- 确认 VSCode 窗口有焦点：任务栏图标是否高亮？远程桌面（RDP/TeamViewer）下拖放常被拦截
- 检查文件是否真为
.vsix：运行unzip -l plugin.vsix，看顶层是否有extension/package.json；若显示一堆零散文件，说明已被解压或损坏 - 路径含中文或空格？Windows 下必须用英文双引号包裹，如
"C:\my ext\ms-python.python-2024.6.0.vsix" - 虚拟机共享文件夹（如
/mnt/hgfs）拖入常失败：先复制到本地路径（如~/Downloads/），再拖
报 “Extension is corrupt” 或 “not compatible with the current version of VS Code”
这不是文件损坏，而是 VSCode 在加载阶段拒绝解析 package.json 或校验失败，最常被忽略的是版本声明不匹配。
- 运行
code --version，取前两位（如1.92.2→1.92） - 解压
.vsix：运行unzip -p plugin.vsix extension/package.json | grep engines，看"vscode": "^1.85.0"这类字段 - 本地版本必须 ≥ 插件要求的最低版本；差一个小版本（如
1.92vs^1.93.0）就会静默拒绝 - ARM 架构机器（如 M-series Mac）不能装 x64 构建的
.vsix：Help → About 里看架构，再去 Marketplace 的versionhistory页面手动选对应平台旧版下载 - 别手动改
package.json后用资源管理器重打包：会破坏 ZIP 结构，必须用zip命令或 7-Zip 重新压缩
装完插件但不生效，怎么确认是否真实加载
插件管理器里标着“已安装”，不代表资源真正加载进来。VS Code 不会主动提示解压失败或依赖缺失，得自己查日志。
- 打开输出面板：
Ctrl+Shift+U→ 下拉菜单中选Log (Window)→ 搜索localization或插件 ID（如ms-python） - 看到
Loaded extension 'ms-python.python'表示成功；出现Failed to activate extension或路径指向空目录，说明加载失败 - 若完全搜不到相关日志，可能插件根本没进加载流程——检查是否被杀毒软件拦截、磁盘权限不足，或
.vscode/extensions目录不可写 - 依赖缺失很隐蔽：比如
ms-python.python强依赖ms-toolsai.jupyter，离线时只装主包会静默失败；需一并下载dependencies字段列出的所有插件 ID
