VSCode安装中文语言包失败90%是代理未走通,根本原因是https://marketplace.visualstudio.com无法连接;需显式配置http.proxy为http://127.0.0.1:7890格式,避开bypass规则,并验证Network面板请求是否发出。

VSCode安装中文语言包失败,90%是代理没走通
不是插件本身坏了,而是 https://marketplace.visualstudio.com 根本没连上。你看到的 Error while installing 'Chinese (Simplified) Language Pack' 只是表象,背后通常是请求卡在 DNS 解析、连接超时或被代理绕过规则拦截。
验证方式很简单:打开开发者工具(Help → Toggle Developer Tools),切到 Network 面板,点一次安装,看有没有对 https://marketplace.visualstudio.com/_apis/public/gallery/ 的请求——如果状态一直是 Pending 或直接没出现,说明请求压根没发出去。
- 别依赖系统代理或浏览器代理,VSCode 完全不读这些
-
http.proxy必须显式配置,且格式必须是http://127.0.0.1:7890(带协议头、用 IP、不能写localhost) - Windows/macOS 默认把
127.0.0.1加入 bypass 列表,填了http://127.0.0.1:7890也可能被跳过
填了 http.proxy 还失败?检查 bypass 规则和 StrictSSL
即使 http.proxy 填对了,VSCode 仍可能因证书或绕过策略静默失败。常见组合错误:
-
http.proxyStrictSSL为true(默认值),但你的本地代理(如 Charles、Fiddler、旧版 mitmproxy)用了自签名证书,会触发DEPTH_ZERO_SELF_SIGNED_CERT错误,Marketplace 页面空白或无限转圈 -
http.proxyBypassList默认包含"<local>"</local>,会自动排除127.0.0.1和localhost—— 换成局域网 IP(如http://192.168.1.100:7890)并确认代理软件开了allow-lan: true - 企业内网代理需额外配
http.proxyAuthorization,格式为Basic base64(user:pass),否则 407 认证失败
Remote-SSH 场景下语言包装不上?远程机器没配代理
本地 VSCode 的 http.proxy 设置不会传给远程服务器上的 vscode-server。Remote 插件/语言包安装失败,几乎全是这个原因。
必须在远程机器上手动编辑:~/.vscode-server/data/Machine/settings.json(注意是 Machine 目录,不是 User 或 Remote),内容只需最小集:
{
"http.proxy": "http://192.168.1.100:8080",
"http.proxyStrictSSL": false
}
改完必须断开并重连 Remote SSH 连接——vscode-server 启动时才读这个文件,热重载无效。
- 别往
~/.bashrc里写export HTTP_PROXY,SSH non-interactive shell 不加载它 - 远程机器上执行
curl -x http://192.168.1.100:8080 https://httpbin.org/ip确认代理通路
实在连不上?手动下载 .vsix 是最稳的兜底方案
当防火墙完全屏蔽外部 HTTPS 请求,或公司策略禁止所有代理中转时,离线安装是最可靠路径。
操作步骤极简:
- 用浏览器打开
https://marketplace.visualstudio.com/items?itemName=ms-ceintl.vscode-language-pack-zh-hans - 点击右上角
Download Extension,得到vscode-language-pack-zh-hans-*.vsix - VSCode 中按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中该文件
注意:.vsix 文件名里的版本号不用匹配当前 VSCode 版本,语言包兼容性很宽;但如果你用的是 VSCode Insiders,建议也下对应版本的包。
真正容易被忽略的是 Machine/settings.json 的位置和 http.proxy 的协议头——少一个 http://,整个配置就形同虚设。


















