rust插件更新卡在“正在下载”是因vs code不走系统代理且不读http_proxy环境变量，导致无法连接marketplace.visualstudio.com；插件图标变灰是因vs code 1.90+根据package.json中engines.vscode字段严格校验版本兼容性。
为什么 Rust 插件更新卡在“正在下载”却没进度
VS Code 本身不负责 Rust 插件的网络请求，而是调用 marketplace.visualstudio.com 接口拉取 vsix 包。国内用户最常遇到的现象是：点“更新”，状态栏显示“正在下载”，但 Network 面板里看不到任何 marketplace 域名的请求，或请求状态码为 0（连接被拦截）、timeout。这不是插件问题，是 VS Code 没走系统代理，也不读 http_proxy 环境变量。
实操建议：
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到Network标签页，再点一次更新，过滤关键词marketplace或vscode-api - 若无请求发出，说明根本没触发下载逻辑——大概率是插件已被新版 VS Code 静默禁用（见下一条）
- 若有请求但失败，检查设置中是否配置了
http.proxy（如http://127.0.0.1:7890），并设http.proxyStrictSSL为false - 临时绕过：启动 VS Code 时加参数
--proxy-server=""，再试更新
Rust 插件图标变灰、命令失效，但列表里还存在
这是新版 VS Code（1.90+）的主动兼容性控制行为，不是插件损坏。它会读每个插件 package.json 中的 engines.vscode 字段，比如 "^1.89.0"，而你当前是 1.92.1，就会直接跳过加载，不报错、不提示、只灰掉。
实操建议：
- 找到插件目录，例如
~/.vscode/extensions/matklad.rust-analyzer-0.4.20240810（Linux/macOS）或%USERPROFILE%\.vscode\extensions\matklad.rust-analyzer-0.4.20240810（Windows） - 打开其中的
package.json，定位engines.vscode字段，把"^1.89.0"改成"^1.92.0"（或更宽泛的=1.89.0 ） - 必须完全退出 VS Code（包括托盘进程），再重启——缓存不清理，改了也白改
- 仅对开源插件（如
rust-analyzer）这么做；闭源插件（如某些 AI 辅助工具）改后可能触发许可证校验失败
更新后 rust-analyzer 报 Cannot find module 'vscode'
这通常不是插件没更新成功，而是它内部依赖的 VS Code API 在新版本中被移除或重命名。比如 1.90+ 移除了部分旧版 vscode 模块导出，或加强了沙箱限制，导致插件启动时 require 失败。
实操建议：
- 先用
code --disable-extensions启动，确认是否能正常加载 rust-analyzer —— 如果可以，说明是扩展冲突 - 再单独启用
rust-analyzer，看 Developer Tools Console 是否抛出Cannot find module 'vscode'或类似错误 - 查该插件 GitHub Issues，确认是否已知问题；常见解法是降级插件（去 Releases 页面下载上一版 vsix）或降级 VS Code（如回退到 1.91.1）
- 注意：Remote-SSH 插件版本也要匹配，
ms-vscode-remote.remote-sshv0.107.x 只适配 VSCode ≤1.102，若你 VS Code 是 1.101 却装了 v0.108.0，也会连带影响 rust-analyzer 的远程分析能力
手动安装 rust-analyzer vsix 后仍不生效
VS Code 安装 vsix 是异步的，且路径含中文或空格会导致 code --install-extension 静默失败——没有报错，但插件不会出现在列表里。
实操建议：
- 确保 vsix 文件路径不含中文、空格、特殊符号（如
/Users/张三/Downloads/rust-analyzer.vsix→ 改为/tmp/rust-analyzer.vsix） - 终端执行：
code --install-extension /path/to/rust-analyzer.vsix，观察是否有输出（成功会显示Extension 'rust-analyzer' was successfully installed.） - 安装后务必重启 VS Code（不是 Reload Window），否则插件注册表未刷新
- 验证是否真正启用：打开任意
.rs文件，按Ctrl+Shift+P输入Rust Analyzer: Show Server Status，能弹出状态面板才算生效
engines.vscode 字段。
