VSCode安装中文语言包失败,根本原因是https://marketplace.visualstudio.com无法连接,导致请求未发出或被拦截;需通过Network面板验证请求是否发出,并检查代理配置、DNS、bypass规则及locale.json路径与格式是否正确。

“Error while installing 'Chinese (Simplified) Language Pack'” 是什么问题
这不是插件本身坏了,而是 VSCode 根本没发出去安装请求——https://marketplace.visualstudio.com 连不上。常见现象是点击 Install 后状态栏卡在“Installing…”,或者弹窗报错但 Network 面板里压根没出现任何请求。根本原因通常是代理配置失效、DNS 污染、或被 bypass 规则静默跳过。
Network 面板看不到 marketplace 请求怎么排查
打开 Help → Toggle Developer Tools,切到 Network 标签页,点一次安装,观察是否有对 https://marketplace.visualstudio.com/_apis/public/gallery/ 的请求发出:
- 如果请求状态一直是
Pending或完全不出现 → 说明请求没发出去,检查http.proxy是否显式配置(不能依赖系统代理) - 如果请求返回
403或ERR_CONNECTION_RESET→ 多半是企业防火墙拦截或 TLS 握手被重置 - 如果请求返回
404→ 可能是 VSCode 1.85+ 默认连open-vsx.org,但国内 DNS 解析失败,fallback 到已停用的旧地址
手动安装 .vsix 仍提示 “Unable to load extension”
VSCode 在加载本地 .vsix 前,仍会尝试联网校验签名。哪怕你断网拖进来了,它也会先发请求;失败后才退到本地加载,而这个过程可能被跳过或中断:
- 必须先彻底断网(关 Wi-Fi / 拔网线),再启动 VSCode,再拖入 .vsix 文件
- 或临时关闭校验:
settings.json加一行"extensions.installVerification": false(验证完务必删掉) - 检查 .vsix 解压后
extension/package.json中的"engines.vscode"字段,确保与本地code --version主版本号兼容(如 1.91.0 → 要写"^1.91.0") - 重打包必须用
zip命令或 7-Zip,Windows 资源管理器双击解压再压缩会破坏 ZIP 结构
装好了但界面还是英文?关键路径和值全对了吗
VSCode 1.70+ 版本只认 locale.json 文件里的 {"locale": "zh-cn"},其他地方写的都无效:
- 文件路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容必须是合法 JSON:双引号、冒号后有空格、值为小写
"zh-cn"(不是"zh_CN"、"zh-hans"或"Chinese") - 必须通过命令面板执行
Configure Display Language并选zh-cn,然后点Restart—— 关闭窗口再手动打开不算重启,后台Code Helper进程还在跑 - 如果该文件存在但值是
"en",可能是工作区设置、远程开发环境或 IT 策略插件覆盖了它;可先关闭文件夹(File > Close Folder)再执行命令绕过干扰
locale.json,或者读到了但值写错了格式、大小写、路径不对、没重启进程。这些细节不验证,装十遍也白搭。



















