vscode安装中文语言包卡在“installing…”是网络链路层问题,主因dns污染、tls握手失败或cdn下载限速;需同时配置serviceurl和cacheurl镜像、手动下载vsix安装,并确保locale.json为{"locale":"zh-hans"}且完全重启。

VSCode安装中文语言包卡在“Installing…”不动,基本可以确定是网络链路层问题——它根本没发出去请求,或者发出去后收不到响应,不是插件坏了,也不是你操作错了。
为什么“正在安装”会无限加载?
VSCode 安装 ms-ceintl.vscode-language-pack-zh-hans 本质是调用 Marketplace API 下载一个 .vsix 文件,整个流程依赖两个关键环节:DNS 解析 + TLS 握手 + HTTP 响应。在国内多数网络环境下(尤其是企业网、校园网、部分宽带运营商),marketplace.visualstudio.com 常出现:
- DNS 污染或解析超时(返回空或错误 IP)
- TLS 握手卡在 Client Hello 阶段(表现为控制台无任何 network 请求)
- 连接建立后,
vscode.blob.core.windows.net的 blob 下载被限速或中断
这些都不会触发明确报错,只会让 UI 停在“Installing…”状态,后台静默挂起。
检查是否真有请求发出(快速验证)
打开命令面板(Ctrl+Shift+P),运行 Developer: Toggle Developer Tools,切到 Network 标签页,再点一次“Install”。观察是否有以下任一请求:
-
GET https://marketplace.visualstudio.com/_apis/public/gallery/...—— 如果没有,说明根本没走通网络栈 -
GET https://vscode.cdn.azure.cn/api/gallery/...—— 有这个才表示镜像配置生效 - 全是
Pending状态,或长时间Waiting for…—— 典型 DNS/TLS 卡死
如果 Network 面板空空如也,别折腾插件或重装,直接改网络路径。
必须同时配 serviceUrl 和 cacheUrl(最容易漏的坑)
VSCode 1.83+ 起,只改 extensions.gallery.serviceUrl 不够,cacheUrl 缺失会导致整个镜像配置被忽略。两者必须:
- 同域(比如都用
https://vscode.cdn.azure.cn) - 结尾带
/(否则拼接路径出错,404) - 写在用户级
settings.json(不是工作区设置) - 改完后彻底退出 VSCode 进程(Windows 右键托盘图标选「退出」;macOS 用 Activity Monitor 杀掉所有
Code和Code Helper)
正确配置示例:
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/api/gallery/", "extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/api/gallery/cache/"
手动安装 + 命令行验证(最稳兜底方案)
图形界面容易静默失败,而 code --install-extension 会立刻输出错误,便于定位:
- 先查版本:
code --version(如输出1.92.2,取前三位1.92.0) - 构造下载地址:
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/MS-CEINTL/vsextensions/vscode-language-pack-zh-hans/1.92.0/vspackage - 下载后执行:
code --install-extension /path/to/ms-ceintl.vscode-language-pack-zh-hans-1.92.0.vsix - 若报
not compatible with VS Code '1.92.2',说明.vsix内extension/package.json的"engines.vscode"字段不匹配,需解压修改后重打包
装完仍不生效?那大概率是 locale.json 没写对或没重启——这个文件只认 {"locale":"zh-hans"},写成 zh-CN 或带 BOM 的 UTF-8 都会回退英文,且必须完全退出再启动,不能只重载窗口。











