VSCode命令行安装.vsix提示“already installed”时需加--force参数强制覆盖,否则默认静默跳过;若仍失败,应先code --uninstall-extension卸载旧版,再--install-extension --force重装,并彻底退出所有VS Code进程以刷新缓存。

VSCode 命令行安装 .vsix 时提示 "Extension 'xxx' is already installed",不是报错,而是它拒绝覆盖——默认行为就是静默跳过,不更新、不报错、也不启用新版本。
code --install-extension 报 "already installed" 怎么强制覆盖
VS Code 的命令行安装器默认不做覆盖,哪怕本地扩展已损坏或版本更旧。关键在加 --force 参数:
-
code --install-extension ./ms-python.python-2024.12.0.vsix --force:强制注册并启用,覆盖原有 ID 对应的全部文件 - 不加
--force时,即使.vsix里package.json的version更高,也完全无效 -
--force不会删用户配置(如settings.json或keybindings.json),只重写扩展目录内容 - 若仍失败,大概率是
engines.vscode版本不匹配,需打开.vsix(用 ZIP 工具)检查extension/package.json中的"vscode": "^1.90.0"是否高于你本地code --version输出值
为什么删了 %USERPROFILE%\.vscode\extensions\ 下文件夹还不行
因为 VS Code 启动时读的是注册表/缓存里的“已注册扩展列表”,不是扫描磁盘。直接删文件夹会导致状态不一致:
- Windows 下,扩展注册信息存在
HKEY_CURRENT_USER\Software\Microsoft\VS Code\Extension子项中,删文件夹不删注册表,下次启动仍认为“已安装” - macOS/Linux 下,
~/.vscode/extensions/里残留.incomplete文件夹会阻塞加载,但不会触发already installed提示——这个提示只来自 ID 冲突 - 正确做法:先
code --uninstall-extension ms-python.python,再--install-extension --force;或者手动删注册表对应项(仅 Windows) - 别用资源管理器直接删正在使用的扩展文件夹,可能被
Code Helper.exe锁住,删完启动时报路径缺失
扩展 ID 重复但想保留旧配置,如何安全升级
ID 重复本质是同一扩展的不同发布源冲突,比如从官网 vsix 和国内镜像 vsix 安装了同名扩展。此时不能只靠 --force:
- 先运行
code --list-extensions --show-versions,确认当前启用的是哪个版本、路径在哪 - 对比两个
.vsix解压后的package.json中publisher+name是否完全一致(如"publisher": "ms-python", "name": "python") - 若 publisher 不同(如
ms-pythonvsms-toolsai),说明是不同维护者发布的同名扩展,强行覆盖可能导致功能异常 - 真正安全的做法:卸载旧版 → 重启 VS Code(确保 extensionHost 进程重载)→ 再装新版;否则插件激活逻辑可能混用两套 API
最常被忽略的一点:VS Code 的扩展系统在启动时会做一次 ID 校验并缓存结果,改完注册表或删完文件夹后,必须彻底退出所有 Code.exe 和 Code Helper.exe 进程,否则缓存未刷新,--force 也会被绕过。











