插件被自动禁用需先检查是否进入Disabled列表：VSCode更新后因engines.vscode版本不匹配（如插件要求^1.84.0而当前为1.102.3）被禁用，可通过命令面板筛选Disabled确认，并安装兼容旧版或手动调整.vsix中package.json。
插件被自动禁用：先看是否进 Disabled 列表
VSCode 更新后，插件“消失”或变灰，大概率不是坏了，而是被自动禁用——因为 package.json 里声明的 "engines": { "vscode": "^1.84.0" } 和你当前的 code --version（比如 1.102.3）不匹配。
打开命令面板（Ctrl+Shift+P），输入 Extensions: Show Installed Extensions，右上角筛选器选 Disabled。如果插件出现在这里，且详情页顶部标着 Disabled，基本就是这个原因。
控制台（Help → Toggle Developer Tools → Console）里常会报类似这样的红字：Extension 'ms-python.python' is not compatible with Code '1.102.3'。
- 别信状态栏图标——它可能只是 UI 残留，实际没加载
- 按
Ctrl+Shift+P输插件命令（如prettier.format），若提示command 'prettier.format' not found，说明确实没激活
重装旧版插件：比改代码更安全省事
扩展面板里点插件右下角 ⋯ → Install Another Version…，选一个和你当前 VSCode 版本匹配的历史版本。这个操作保留市场签名验证，也绕过了手动解包改 package.json 的风险。
如果该选项灰显，说明 VSCode 市场没收录对应版本，或作者没发布——这时才需要去 GitHub Release 页面下载 .vsix 文件手动安装。
- 手动安装前，先关掉所有 VSCode 实例
- 用命令行安装更可靠：
code --uninstall-extension publisher.name.extension && code --install-extension ./xxx.vsix - 别双击安装
.vsix——它会跳过兼容性校验直接失败
插件已启用但功能不响应：检查 activationEvents 和依赖
插件显示“已安装”却始终灰色、命令无反应，常见原因是 package.json 里写的 activationEvents 没触发。比如只声明了 "onLanguage:python"，而你打开的是空窗口或 .txt 文件，插件根本不会加载。
打开插件详情页（点 ⓘ 图标），看 Activation Events 字段；或在命令面板运行 Developer: Toggle Developer Tools，切换到 Console 标签，刷新后搜 Activating extension 看有没有失败日志。
- 尝试新建一个匹配语言的文件（如
test.py），保存后再观察插件是否变亮 - 报
Cannot find module 'xxx'？说明插件没把依赖打进发布包，手动安装的.vsix很容易出这问题 - 卸载插件后，手动删掉
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）里对应文件夹再重装
崩溃或白屏打不开：必须用 code --disable-extensions
如果 VSCode 启动就卡死、闪退，或者连扩展面板都打不开，别在 UI 里点“禁用全部扩展”——那只是写配置，很多插件（比如 ms-python.python）会在启动早期注入代码，禁用逻辑根本来不及生效。
code --disable-extensions 是唯一能 100% 跳过所有插件加载流程的方式：不读 settings.json、不扫描 extensions.json、不调任何 activate() 函数。
- 确认是插件导致崩溃后，用
code --disable-extension ms-python.python逐个排除，比全关再一个个开更高效 - 日志为空？说明崩溃发生在日志写入之前，必须退回命令行阶段
- 某些插件（如旧版 SFTP、AI 补全类）启动时会
spawn外部进程，路径含中文、空格或权限不足会导致静默失败——这种错误只藏在exthost日志末尾，UI 完全不提示
真正麻烦的不是插件多，而是有些插件在启动极早期就介入，连禁用配置都来不及读取。排查时优先信命令行输出和 exthost 日志，而不是界面状态。
