最准方法是查看Extension Management日志：Ctrl+Shift+P执行Developer: Open Extension Logs，选Extension Management，可完整追踪安装链路，暴露Failed to fetch、签名失败、解压错误等根本原因。
直接看 Extension Management 日志最准
VSCode 插件安装失败时，界面只显示“安装失败”或卡在进度条，根本看不出哪一步断了。真正有效的日志不在 Output 面板，而在 Extension Management 日志里——它记录从点击安装、下载、解压到注册的完整链路。
操作路径：Ctrl+Shift+P → 输入并执行 Developer: Open Extension Logs → 侧边栏选 Extension Management（不是 Extension Host）。常见错误会直接暴露：比如 Failed to fetch 是网络问题，Signature verification failed 是证书或中间人拦截，ENOENT: no such file or directory, open '.../package.json' 说明解压失败或目录权限不对。
- 如果日志里出现
ETIMEDOUT或ECONNREFUSED，基本锁定为代理或防火墙阻断marketplace.visualstudio.com - 日志中若反复出现
Installing extension from ...vsix但无后续，说明 vsix 文件本身损坏，可尝试用unzip -t your-plugin.vsix校验完整性 - Linux/macOS 下若提示
EPERM，大概率是~/.vscode/extensions目录被 root 写入过，需chown -R $USER:$USER ~/.vscode/extensions
Console 里报错比弹窗更真实
开发者控制台（Ctrl+Shift+I）的 Console 标签页，常能捕获 UI 层面无法展示的底层异常。比如插件市场请求被 CORS 拦截、JSON 解析失败、或 fetch 调用抛出未处理的 promise rejection。
关键操作：打开控制台 → 点击安装按钮 → 立即观察红色报错。常见线索包括：
-
net::ERR_CONNECTION_REFUSED：本地代理服务（如 Charles/Fiddler）开着但没运行，或系统代理配置指向了无效端口 -
Uncaught (in promise) TypeError: Cannot read properties of undefined：扩展包结构异常，比如根目录缺extension/package.json -
Failed to load resource: the server responded with a status of 403：企业网络策略封禁了 marketplace 域名，需联系 IT 开放https://marketplace.visualstudio.com
locale.json 错一个字符，中文就不出
中文插件装了却没反应？90% 的问题不在插件本身，而在 locale.json 文件。VS Code 1.70+ 版本只认这个文件里的 {"locale":"zh-cn"}，其他任何地方写的都不生效。
路径必须准确：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
~/Library/Application Support/Code/User/locale.json - Linux：
~/.config/Code/User/locale.json
内容必须严格符合 JSON 规范："zh-cn" 不能写成 "zh_CN"、"zh-hans" 或漏掉双引号。多一个空格、逗号或换行符，VS Code 就会静默回退到英文。
验证方式：Ctrl+Shift+U → Output 面板选 Log (Window) → 搜索 locale，正常应看到 Loaded locale zh-cn from ...；若出现 Failed to load localization，说明文件路径或内容有误。
离线安装 vsix 时版本不匹配是隐形杀手
手动下载 .vsix 安装失败，提示 not compatible with Code，往往不是 VS Code 版本太旧，而是插件声明的兼容范围太窄。
解压 vsix（本质是 zip）→ 打开 extension/package.json → 找 "engines": {"vscode": "^1.85.0"} 这一行。如果你本地是 1.91.0，而插件只声明支持 ^1.85.0，VS Code 就会拒绝加载。
- 修改时只需把
"^1.85.0"改成你本地的主版本号，例如"^1.91.0"（注意保留^和双引号） - 重新打包必须用命令行：
zip -r new-plugin.vsix extension/，Windows 资源管理器右键“发送到压缩文件夹”会破坏 ZIP 结构，导致静默失败 - 改完后校验：
unzip -l new-plugin.vsix | grep package.json，确保路径是extension/package.json，不是package.json或extension/extension/package.json
日志里最易被忽略的是时间戳和路径拼接细节——比如 marketplace.visualstudio.com/vscode 和 marketplace.visualstudio.com 是两个不同接口，错误的 URL 会导致 404 却不报明确错误。
