VSCode扩展安装后“重名”错误本质是插件ID重复或缓存残留导致激活失败；需彻底退出进程后按ID前缀清理旧版本文件夹、检查settings.json中gallery URL唯一性并确保结尾带/，再重启生效。
VSCode 扩展安装后出现“重名”错误，本质不是名字冲突，而是插件 ID 重复或缓存残留导致激活失败；直接删缓存+改配置比重装更有效。
扩展面板显示“已安装”但禁用状态，点启用报“Extension with identifier ‘xxx’ is already registered”
这是典型的扩展注册表污染：VS Code 启动时从 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\（Windows）加载插件，若同一 ID 的多个版本目录共存（比如 esbenp.vscode-eslint-2.4.12 和 esbenp.vscode-eslint-2.4.13 同时存在），语言服务初始化阶段会因 ID 冲突拒绝激活。
- 完全退出 VS Code（包括后台
Code Helper进程） - 进扩展目录，按插件 ID 前缀分组（如
ms-python.python-、esbenp.vscode-eslint-），只保留最新版本文件夹，其余全删 - 别信“重命名文件夹能绕过”，VS Code 校验的是
package.json里的id字段和签名，不是文件夹名 - 重启后进命令面板运行
Developer: Reload Window，不是单纯刷新窗口
手动安装 .vsix 后提示 “Extension 'xxx' is already installed” 却无法启用
VS Code 对 .vsix 安装有两层校验：一是 package.json 中的 id 是否已在本地注册表中存在，二是 engines.vscode 版本是否匹配。ID 重复时它不会覆盖，而是静默失败。
- 先确认当前 VS Code 版本：
code --version输出第一行（如1.85.2） - 用 ZIP 工具打开 .vsix，检查
extension/package.json里"engines": { "vscode": "^1.90.0" }—— 若版本高于你本地，必报错 - 若 ID 确实重复，不要删整个
extensions/，只删对应 ID 前缀的文件夹（如删掉ms-python.python-2024.12.0，再重装新 .vsix） - 命令行安装时加
--force参数：code --install-extension foo.vsix --force，强制覆盖已注册 ID
settings.json 里误配了重复的 extensions.autoUpdate 或 gallery URL 导致市场页空白
VS Code 不会合并重复键，而是取最后一个声明值；但若 extensions.gallery.serviceUrl 被写了两次且第二次值非法（如少斜杠、协议错写成 htp://），整个扩展市场请求会静默失效，界面不报错只显示空列表。
- 打开
settings.json（Ctrl+Shift+P→Preferences: Open Settings (JSON)） - 搜
gallery，确保只有且仅有一组"extensions.gallery.serviceUrl"和"extensions.gallery.cacheUrl"，值必须以https://开头、结尾带/ - 国内推荐值：
"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"（注意末尾斜杠） - 改完保存，必须彻底退出 VS Code 再重开——热重载不重读 gallery 配置
真正麻烦的不是重名本身，而是 VS Code 把插件 ID 当作唯一主键写进内存注册表后，不会主动清理旧记录。哪怕你删了所有文件夹，只要没执行 --user-data-dir 重置，下次启动仍可能从残留元数据里拉出冲突 ID。
