必须从官方市场下载正版.vsix文件:访问https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans,拉至页面底部点击“Download Extension”,获取如MS-CEINTL.vscode-language-pack-zh-hans-1.118.0.vsix的文件,校验package.json中vscode版本兼容性,再通过命令面板执行Extensions: Install from VSIX安装,并配置locale为"zh-cn"后彻底重启。

怎么下载正版中文语言包 .vsix 文件
必须从官方市场页面获取,其他来源基本不可信。打开 https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans,拉到页面最底部,点「Download Extension」——得到的是形如 MS-CEINTL.vscode-language-pack-zh-hans-1.118.0.vsix 的文件。
别用百度搜出的网盘链接、exe 封装器或“一键汉化包”,那些不是过期就是带静默行为;第三方镜像站(如 vsix.2i.gs)不校验签名,内网部署风险高。
下载后建议解压检查 package.json 中的 "engines": {"vscode": "^1.118.0"},确保版本前两位(如 1.118)与你本地 code --version 输出一致。Stable 和 Insiders 版本的语言包不通用,混用必失效。
离线安装 .vsix 必须走命令面板
双击 .vsix 或拖进 VSCode 窗口,VSCode 自 1.70 起已禁用该方式,会静默失败且无提示——你以为装上了,其实只是把文件扔进了 ~/.vscode/extensions/ 目录,根本没注册进扩展系统。
正确做法是:
- 按
Ctrl+Shift+P打开命令面板 - 输入并执行
Extensions: Install from VSIX - 在弹出框中选中你下载的 .vsix 文件,点击 Install
装完不会自动弹窗,也别指望“重载窗口”生效——这一步只是完成插件注册,还没切换语言。
locale 配置必须为 "zh-cn"(小写 + 连字符)
很多人卡在这步:插件装了、也重启了,界面还是英文。根本原因是 locale.json 里写的不是 "zh-cn",而是 "zh-CN"、"zh"、"zh-hans" 或空字符串。
VSCode 内部语言协商机制只认标准 BCP 47 格式,且优先匹配语言包 ID 后缀。官方包 ID 是 ms-ceintl.vscode-language-pack-zh-hans,但主程序默认只把 "zh-cn" 当作完整 UI 切换标识——写成 "zh-hans" 在 1.95+ 版本会导致设置页、调试面板仍为英文。
操作路径:
- 按
Ctrl+Shift+P→ 输入并执行Configure Display Language - 确认打开的是全局
locale.json,不是工作区.vscode/settings.json(后者会覆盖前者) - 把内容改成:
{"locale": "zh-cn"} - 保存后必须彻底重启 VSCode——“重载窗口”不生效
装完还是英文?先关掉后台进程再重试
VSCode 启动时若已有旧进程在后台运行(比如上次没关干净),新配置可能被绕过。Windows 上任务管理器里搜 Code.exe,macOS/Linux 上运行 pkill -f "code --ms-enable-electron-run-as-node" 彻底清空。
另外两个隐蔽坑:
- 启动方式错误:双击旧桌面快捷方式,实际打开的是已卸载的老版本 VS Code 目录 → 改从「开始菜单」或「应用坞」里重新打开
- 系统 locale 干扰:Windows 若区域设为 English (United States) 且勾了「Beta: Use Unicode UTF-8…」,会跳过语言包;macOS/Linux 检查
echo $LANG,若是en_US.UTF-8,就得手动干预
真正麻烦的从来不是下载或安装,而是这些配置项之间互相覆盖、进程残留、大小写和连字符这种肉眼难辨的细节。


















