应改用vscode.cdn.azure.cn镜像源配置serviceUrl和cacheUrl,或手动下载vsix用code --install-extension安装,并确保locale.json为{"locale":"zh-hans"}且完全重启。

VSCode中文语言包下载卡在“Installing…”怎么办
不是插件坏了,是 VS Code 默认直连 marketplace.visualstudio.com,这个域名在国内常 DNS 污染、TLS 握手失败或连接重置。你看到的进度条实际在等一个根本收不到的响应,UI 却不报错。
常见现象包括:
- 右下角提示“Installing extension…”持续数分钟不动
- 点击 Install 后按钮变灰,无后续反馈
- 命令面板执行
Extensions: Install from VSIX后静默无响应
用 vscode.cdn.azure.cn 镜像源改 settings.json
这是目前最稳定、更新及时的国内替代方案,无需代理,兼容 VS Code 1.75+ 所有版本。关键要彻底关闭所有 VS Code 进程(Windows 任务管理器里确认没有 Code.exe 或 Code Helper;macOS/Linux 执行 pkill -f "Code Helper"),再操作。
编辑用户设置文件:
- Windows:
%APPDATA%\Code\User\settings.json - macOS:
$HOME/Library/Application Support/Code/User/settings.json - Linux:
~/.config/Code/User/settings.json
添加两行(注意逗号分隔,末尾必须带 /):
{"extensions.gallery.serviceUrl":"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/","extensions.gallery.cacheUrl":"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/publishers"}
保存后彻底重启 VS Code,再进扩展页安装,基本能秒进下载流。
手动下载 .vsix + 命令行安装(最可靠)
图形界面容易静默失败,尤其含 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 路径含空格需加引号)
若报 Extension is not compatible with Code,说明 package.json 中 engines.vscode 字段不匹配,需解压修改后重新打包。
离线安装后界面仍是英文?重点检查 locale.json
装完不生效,90% 是因为没走对流程,而不是文件错了。双击 .vsix 或拖拽进窗口只是复制文件,不会注册扩展 ID、不触发语言资源加载——VS Code 自 1.70 起已禁用直接加载机制。
必须做三件事:
- 通过命令面板执行
Extensions: Install from VSIX安装(不能双击) - 手动创建
locale.json文件,路径严格对应系统:
Windows:%APPDATA%\Code\User\locale.json
Linux:~/.config/Code/User/locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json - 内容严格为:
{"locale":"zh-cn"}(小写、连字符、双引号、UTF-8 无 BOM)
填 zh-hans 在 1.95+ 版本中仅加载基础 UI 字符串,设置页、终端面板、调试视图仍为英文;填 zh_CN 或 chinese VS Code 会直接忽略该字段。
真正卡点不在下载速度本身,而在于:镜像源改了但后台进程没杀干净、locale.json 编码带 BOM、语言包版本和 VS Code 主体不匹配——这三处任何一个出问题,都会导致“明明装了却还是英文”。


















