离线vscode汉化核心是安装官方zh-hans语言包并手动执行configure display language选zh-cn。必须通过install from vsix安装.vsix文件,再重启并设置locale为"zh-cn",否则界面仍为英文。

离线状态下 VSCode 设置中文,核心就两件事:装对语言包、手动激活 zh-cn。装错包或跳过激活步骤,界面大概率仍是英文,甚至部分区域乱码。
怎么下载并安装离线语言包(.vsix 文件)
离线环境无法访问扩展市场,必须提前获取官方 .vsix 文件。微软只提供一个稳定入口:https://go.microsoft.com/fwlink/?LinkId=629593(该链接长期有效,指向最新版简体中文包)。打开后选择与你本地 VS Code 版本匹配的 vscode-language-pack-zh-hans.vsix 下载——版本不匹配可能导致安装失败或语言项缺失。
安装方式固定:
- 在 VS Code 中按
Ctrl+Shift+P打开命令面板 - 输入并执行
Extensions: Install from VSIX - 选中下载好的
.vsix文件,点击 Install - 安装完成后状态栏会显示 “Installed”,但此时界面仍为英文
为什么装完还是英文?必须手动触发 Configure Display Language
语言包只是资源容器,VS Code 不会自动启用它。离线环境下尤其容易卡在这一步:用户以为“装完就完事”,结果重启后右下角仍显示 en。
正确做法是:
- 按
Ctrl+Shift+P,输入Configure Display Language - 从下拉列表中明确选择
zh-cn(注意是小写、连字符,不是zh_CN或Chinese) - 点击
Restart或手动关闭再启动
如果命令面板打不开(比如插件冲突导致 UI 卡死),可跳到下一步直接改配置文件。
手动编辑 locale.json 的关键细节
当命令面板不可用,或需批量部署时,必须编辑 locale.json。路径因系统而异:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容必须严格为:
{"locale": "zh-cn"}
常见错误包括:
- 写成
"locale": "zh_CN"或"locale": "Zh-cn" - 多加了逗号导致 JSON 解析失败
- 被其他插件(如某些主题)覆盖了该字段值
保存后执行 Developer: Reload Window 即可生效,无需完全退出 VS Code(旧版本 1.7x 及更早可能仍需全重启)。
字体乱码或中文显示过小怎么办
语言切换成功后,若编辑器内中文发虚、挤在一起或字号异常小,问题不在语言包,而在字体配置。
打开设置 JSON(Ctrl+, → 右上角 Open Settings (JSON)),添加或修改:
"editor.fontFamily": "'Microsoft YaHei', 'PingFang SC', 'Helvetica Neue', sans-serif",<br>"editor.fontSize": 14
注意:
-
Microsoft YaHei(微软雅黑)在 Windows 上最稳妥;macOS 推荐PingFang SC;Linux 可用Noto Sans CJK SC - 引号必须是英文双引号,字体名带空格时需用单引号包裹
- 不要删除原有配置项,只增补或覆盖这两项即可
真正容易被忽略的是:离线安装后,Configure Display Language 这一步永远不能跳过——它不是“可选项”,而是唯一能告诉 VS Code “现在请用中文”的开关。











