最准确认方式是：打开命令面板运行extensions: show installed extensions并筛选disabled，或开发者工具console中搜索“not compatible”，或插件详情页显示disabled；三者任一成立即表明版本不匹配。
code --install-extension 安装后插件不生效，怎么确认是不是版本不匹配？
不是所有“装了但没反应”都算失败——VS Code 在加载前就校验 engines.vscode 字段，不满足直接静默禁用，连报错都不给。最准的验证方式只有三个：
- 打开命令面板（
Ctrl+Shift+P），运行Extensions: Show Installed Extensions，右上角筛选器选Disabled，插件出现在列表里就是它 - 开发者工具（
Help → Toggle Developer Tools）→ Console 标签页，搜红字not compatible with Code '1.xxx.x' - 插件详情页右下角显示
Disabled，且右键菜单只有Disable (For All Workspaces)，没有启用项
手动改 .vsix 里的 engines.vscode 字段，为什么不能双击解压？
.vsix 是 ZIP 包没错，但 VS Code 安装时会校验包结构和签名。双击用系统归档工具解压、再拖回打包，会破坏内部目录层级或元数据，导致安装失败或加载异常。必须用专业解包工具处理：
- Windows：用
7-Zip打开xxx.vsix，进入extension/package.json（注意是extension/子目录下的那个，不是根目录） - macOS：用系统自带
Archive Utility解压，别用预览或访达双击 - Linux：用
unzip xxx.vsix -d temp_dir，改完再zip -r new.vsix temp_dir/* - 改字段示例：
"vscode": "^1.103.0"→ 改成"vscode": ">=1.85.0"（推荐宽松范围），别写死"=1.103.0"，否则 minor 升级（如1.103.1）又挂
装完旧版插件，为什么右下角还显示 Disabled？
改完 .vsix 重装只是第一步。VS Code 不会自动 reload 插件，尤其当插件已存在但被禁用时：
- 如果插件已安装但灰显，不用卸载，直接进插件目录（
~/.vscode/extensions/作者名.插件名-版本号/或%USERPROFILE%\.vscode\extensions\作者名.插件名-版本号\），编辑里面的package.json，改engines.vscode - 保存后，必须执行
Developer: Reload Window（命令面板里搜），点「启用」按钮无效 - Remote-SSH / Remote-Containers 类插件还要额外处理远端：
~/.vscode-server目录下二进制版本必须和本地 VS Code 主版本一致，否则连接卡在Starting VS Code Server
code --install-extension 命令报错 ENOENT 或静默失败，路径怎么写才对？
这个命令对路径极其敏感，中文、空格、括号、符号链接都会触发失败。不是权限问题，是解析器直接拒掉：
- 路径必须是**绝对路径**，且全英文、无空格、无括号（比如
C:\Users\Alice\Downloads\prettier-9.10.3.vsix可以，C:\Users\Alice\Downloads\My Extensions\不行） - macOS/Linux 下别用
~/开头，用完整路径（/Users/alice/Downloads/），否则codeCLI 无法展开 - Windows 用户若路径含空格，命令行里要加引号：
code --install-extension "C:\path\to\extension.vsix"；但 VS Code 内部处理时自己会处理，不用手动转义 - 装完别只看 UI，进插件详情页确认右下角 Version 是否更新；更关键的是检查插件目录下
package.json里的engines.vscode是否真改对了
extensions.autoUpdate 是 true，几小时后就会被新版覆盖。关掉它，同时检查插件详情页是否勾选了 Switch to Pre-release Version。
