VSCode macOS 中文界面需装官方中文语言包并运行Configure Display Language命令选zh-cn后重启;locale.json须严格置于~/Library/Application Support/Code/User/且内容为{"locale": "zh-cn"};终端英文属正常设计。

VSCode 在 macOS 上界面仍是英文,90% 是因为没执行 Configure Display Language 命令,或 locale.json 文件路径/内容不合法——装插件只是放字典,不等于翻书。
必须认准 Microsoft 官方中文语言包
在扩展面板(Cmd+Shift+X)里搜 Chinese (Simplified) Language Pack for Visual Studio Code,只装发布者为 Microsoft、ID 是 ms-ceintl.vscode-language-pack-zh-hans 的那个。其他名字近似的,比如 Chinese Language Pack 或带“汉化”字样的第三方包,会导致命令面板乱码、设置项不翻译,甚至覆盖正确配置。
常见错误包括:
- 点开搜索结果第一项就装,但发布者不是
Microsoft - 看到下载量高就信,没核对 ID 和签名
- 装完发现「设置」页面还是英文,误以为插件失效,其实只是还没启用
Configure Display Language 命令必须手动运行且选 zh-cn
装完插件后,按 Cmd+Shift+P 打开命令面板,输入并完整选择 Configure Display Language(注意不是 Configure Language 或 Preferences: Configure Language)。这个命令是唯一能写入并触发生效的入口。
关键细节:
- 列表中只认
zh-cn(全小写、短横线),不接受zh-CN、zh-hans、Chinese或任何中文文字项 - 选完会弹提示框,必须点
Restart——Reload Window不重载语言环境,右下角状态栏仍显示en - 如果命令搜不到,大概率是插件没装成功,或 VS Code 版本低于 1.70(已极少见)
locale.json 路径和格式必须严格匹配 macOS 系统规范
VS Code 只读取用户级 locale.json,且只认纯 JSON 格式。手动生成、写错位置、大小写或标点,都会静默回退英文。
必须满足以下全部条件:
- 文件路径:
~/Library/Application Support/Code/User/locale.json - 文件内容仅一行合法 JSON:
{"locale": "zh-cn"}(注意双引号、冒号后有空格、值全小写、用短横线) - 不能有注释、不能多字段、不能漏逗号、不能写成
zh_CN或zh-hans - 若文件被企业策略或脚本覆盖,需手动清空为仅保留该键值对
验证方式:直接打开该路径确认文件存在;重启后右下角状态栏应显示 zh-cn,点击它也能快速切换。
终端和调试控制台仍是英文属于正常设计
菜单、设置页是中文,但集成终端(Cmd+`)或调试控制台(Debug Console)仍显示英文——这不是配置失败,而是 Electron 子进程不继承主窗口的 locale 设置。它们的语言由系统环境变量(如 LANG)或启动参数决定。
如果你真需要终端也中文,可临时在终端里执行:
export LANG=zh_CN.UTF-8
但这不影响 VS Code 主界面,也不推荐全局修改系统 LANG,容易引发其他 CLI 工具异常。
真正容易被忽略的是:改了 locale.json 后没彻底退出 VS Code 进程。macOS 下要检查「活动监视器」里是否还有残留的 Electron 或 Code Helper 进程,否则新配置根本不会加载。



















