VSCode中“Command 'xxx' is already registered”报错表明至少两个插件注册了相同命令ID，导致后加载的覆盖先加载的；应使用Developer: Start Extension Bisect二分定位冲突插件，禁用无效时需彻底删除extensions目录下旧版本插件文件夹，并检查package.json中engines.vscode兼容性。
“Command 'xxx' is already registered”就是重复检测冲突的明确信号
VSCode 里出现这个报错，不是警告，是铁证：至少两个插件注册了完全相同的命令 ID，比如 editor.action.findInFiles 或 prettier.format。VSCode 不会报错中断，而是静默丢弃先注册的，只保留最后一个加载成功的——所以你点格式化，实际执行的可能是另一个插件的逻辑，结果却以为“Prettier 没生效”。右键菜单项消失、快捷键按了没反应、弹出两个重复提示，基本都源于此。
用 Developer: Start Extension Bisect 快速定位冲突插件
别手动一个个禁用，太慢还容易漏。VSCode 内置的二分排查法才是正解：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入并运行Developer: Start Extension Bisect - 它会自动禁用一半插件，让你测试问题是否还在；如果还在，说明问题插件在另一半里；如果没了，说明在刚禁用的那半里
- 重复这个过程，通常 3–4 轮就能缩到 1–2 个嫌疑插件
- 重点盯住近期更新/安装的插件，尤其是同类型功能的（比如多个 AI 补全、多个 Vue 支持、多个格式化工具）
禁用不等于清除，必须删目录才能彻底解决抢注
很多插件（如旧版 ms-python.python）即使被禁用，也会在 VSCode 启动初期抢先注册命令，导致后续插件注册失败。这时候光在 UI 上点“禁用”毫无意义：
- 完全退出 VSCode，包括后台进程（Windows 任务管理器查
Code Helper，macOS 活动监视器查Code Helper (Renderer)） - 进扩展目录：
%USERPROFILE%\.vscode\extensions\（Win）或~/.vscode/extensions/（macOS/Linux） - 按插件 ID 前缀分组（如
esbenp.prettier-vscode-、dbaeumer.vscode-eslint-），只保留最新版本文件夹，其余全删 - 重启 VSCode 后再运行
Developer: Reload Window，不是普通刷新
检查 engines.vscode 版本兼容性，避免静默禁用
插件装了但灰着、命令面板搜不到、控制台报 Extension 'xxx' is not compatible with Code '1.102.3'，大概率是版本不匹配。VSCode 启动时直接跳过不兼容插件，连日志都可能不打：
- 打开终端，运行
code --version看当前版本（如1.102.3） - 进对应插件目录，打开
extension/package.json，搜"engines"字段，看"vscode": "^1.103.0"这类值 - 若本地版本低于插件要求的最低版本，它必然不会激活；此时要么升级 VSCode，要么回退插件版本（从 marketplace 下载旧版 .vsix）
- 验证是否真激活：开发者工具 Console 里执行
console.log(!!vscode.extensions.getExtension("publisher.name")?.isActive)，输出false就确认没起来
真正卡住人的，往往是“禁用后仍残留注册”和“版本不匹配却无提示”这两点。前者得删物理目录，后者得翻 extension/package.json 里的 engines.vscode——UI 层面看到的“已安装”，根本不等于“已加载”。
