vs code 扩展安装卡在“installing…”是因直连 marketplace.visualstudio.com 失败,推荐改用 vscode.cdn.azure.cn 镜像源并修改 settings.json,或手动下载 .vsix 用命令行安装,同时确保 locale.json 正确且完全重启。

卡在“Installing…”不是插件坏了,也不是你点错了——是 VS Code 在等一个根本收不到的响应。
为什么卡住?本质是 marketplace 请求挂起
VS Code 默认直连 marketplace.visualstudio.com,这个域名在国内常被 DNS 污染、TLS 握手失败或连接重置。你看到的进度条,实际是等待 .vsix 文件流下载完成,但请求早已 pending 或超时,UI 却不报错。
- 右下角提示“Installing extension…”持续数分钟不动
- 点击 Install 后按钮变灰,无后续反馈
- 命令面板执行
Extensions: Install from VSIX后静默无响应
改用 vscode.cdn.azure.cn 镜像源(推荐首选)
这是目前最稳定、更新及时的国内替代方案,无需代理,兼容 VS Code 1.75+ 所有版本。
- 彻底关闭 VS Code 全部进程(Windows 任务管理器 / macOS 活动监视器里确认没有
Code Helper或Code进程残留) - 编辑用户设置文件:
%APPDATA%\Code\User\settings.json(Windows)、~/Library/Application Support/Code/User/settings.json(macOS)、~/.config/Code/User/settings.json(Linux) - 添加两行(注意逗号分隔,末尾必须带
/):"extensions.gallery.serviceUrl":"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/","extensions.gallery.cacheUrl":"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/publishers"
- 保存后彻底重启 VS Code,再进扩展页安装
手动下载 .vsix + code --install-extension 命令行安装(最可靠)
图形界面容易静默失败,尤其含 native 二进制的扩展;命令行会立刻输出具体错误,方便定位。
- 查当前版本:
code --version(输出如1.90.2,取前三位1.90.0) - 构造官方下载地址:
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/MS-CEINTL/vsextensions/vscode-language-pack-zh-hans/1.90.0/vspackage - 下载后执行:
code --install-extension /path/to/ms-ceintl.vscode-language-pack-zh-hans-1.90.0.vsix(Linux/macOS 绝对路径;Windows 路径含空格需加引号) - 若报
not compatible with Code,说明package.json中engines.vscode字段不匹配,需解压修改后重新打包
装完还是英文?检查 locale.json 和进程残留
中文包不是“装上就生效”,它依赖三个条件同时满足:插件已安装、locale.json 值正确、VS Code 完全重启。
-
locale.json必须放在用户级配置路径,内容严格为:{"locale":"zh-hans"}(小写、短横线、UTF-8 无 BOM) - 别用记事本保存,BOM 会导致 JSON 解析失败,界面直接回退英文
- 装完必须完全退出 VS Code(关掉所有窗口 + 托盘图标右键退出),不能只“重载窗口”
- Windows 上残留
Code.exe或Code Helper进程会导致新启动实例加载旧缓存
真正卡住的地方,往往不是网络本身,而是临时目录被杀软锁死、locale.json 写错格式、或者后台进程没清干净——这些细节不手动确认,换十种方法都白试。











