确认兼容性需查插件package.json中engines.vscode字段，对比code --version输出；若不满足则静默禁用，可通过Disabled列表、控制台not compatible报错或console.log(!!vscode.extensions.getExtension()?.isActive)为false验证。
怎么确认插件版本和 VS Code 版本是否兼容
VS Code 安装插件时不会报错，但会静默禁用不兼容的版本——你点开插件详情页看到“Enabled”，实际根本没加载。关键看 package.json 里的 engines.vscode 字段：比如值为 "^1.76.0"，表示最低支持 VS Code 1.76，且只兼容 1.x 系列；若你用的是 1.90.2，它能跑；但若字段写的是 "^1.85.0"，而你本地是 1.79.2，插件就会被自动禁用。
验证方法有三：
– 打开插件安装目录（如 ~/.vscode/extensions/esbenp.prettier-vscode-9.10.3/package.json）直接查字段
– 终端执行 code --list-extensions --show-versions，如果输出里有 @9.10.3 但插件功能不生效，大概率就是 engines 不匹配
– 按 Ctrl+Shift+P 输入 Developer: Toggle Developer Tools，在 Console 里搜 not compatible，常会看到类似 Extension 'xxx' is not compatible with Code 1.79.2 的提示
从哪找靠谱的 .vsix 文件
GitHub Releases 是唯一稳定来源，尤其对 Microsoft 官方插件（ms-python.python、ms-vscode.cpptools、ms-python.pylance）和主流第三方（esbenp.prettier-vscode、dbaeumer.vscode-eslint）。不要信 Marketplace 页面右上角的 “Download Extension” 按钮——2025 年起它已失效，生成的链接带临时 token，离开页面就 404。
正确路径是：
– 拼出仓库地址：https://github.com/{publisher}/{extension-name}/releases，例如 https://github.com/microsoft/vscode-python/releases
– 找带 v 前缀的 tag（如 v2023.10.11568070），别选 Source code zip
– 在 Assets 区域下载后缀为 .vsix 的文件（文件名通常含插件 ID 和版本号，如 ms-python.python-2023.10.11568070.vsix）
– 极少数插件没发 .vsix（如某些企业内部工具），只能查社区存档或联系作者索要
安装时路径和进程的硬性要求
code --install-extension 对路径零容忍：含中文、空格、括号、emoji 都会触发 ENOENT 或静默失败。必须用纯英文路径，例如 /Users/me/Downloads/python-2023.10.vsix 可以，/Users/张三/Downloads/Python (old).vsix 不行。
安装前务必关闭 VS Code 全局进程（macOS 注意 Dock 图标右键退出，Windows 检查任务管理器有没有残留 Code Helper 进程）。否则常卡在 “Running extension installation…” 无响应。装完必须重启，否则插件不加载、版本号也不更新。
macOS 用户双击 .vsix 提示“已损坏”，不是文件问题，是 Gatekeeper 限制。绕过方式只有命令行：code --install-extension /path/to/extension.vsix。
装完怎么防自动覆盖
默认 extensions.autoUpdate 是 true，VS Code 每小时检查一次更新。更坑的是预发布版（pre-release）版本号更高，比如你刚装的 9.10.3 很可能被 10.0.0-pre.1 覆盖——UI 上甚至不提示，插件就突然失灵了。
必须同时做两件事：
– 设置中搜 extensions.autoUpdate，设为 false
– 打开插件详情页 → 点右上角 ⋯ → 确认没勾选 Switch to Pre-release Version
– 再次验证：code --list-extensions --show-versions 输出是否稳定，插件目录下 package.json 的 version 字段是否始终是你指定的旧版
真正容易被忽略的是 Remote-SSH 场景：前端装了旧版，远端 vscode-server 版本不匹配照样不工作，得同步检查并降级远端 server。
