VS Code 1.70+ 版本不再自动生成 locale.json,必须手动创建于用户级指定路径,内容严格为 {"locale":"zh-cn"}(小写、连字符、UTF-8无BOM),并彻底退出进程后重启才生效。

locale.json 文件必须手动创建,VS Code 不会自动生成
VS Code 从 1.70 版本起彻底移除了 settings.json 中的 "locale" 支持,改用独立的 locale.json 文件控制界面语言。这个文件默认不存在,哪怕你装了中文语言包、执行过 Configure Display Language 命令,也可能因路径错误或进程残留导致没写成——所以最稳的方式就是自己建。
路径和文件名一个字符都不能错
常见失败不是因为不会写 JSON,而是放错了地方。必须严格匹配系统平台路径:
- Windows:
%APPDATA%\Code\User\locale.json(等价于C:\Users\{用户名}\AppData\Roaming\Code\User\locale.json) - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
注意:locale.json 是固定文件名,不能写成 locale.js、local.json 或 locale.json.txt;目录层级中的 User 也不能漏掉或拼错。
内容只有一行,且必须是合法 JSON
文件内容只能是这一个对象,无空格、无注释、无 BOM:
{"locale":"zh-cn"}
关键细节:
-
"zh-cn"必须全小写、用连字符,zh_CN、ZH-CN、Chinese、zh-hans全部无效 - 外层必须是大括号,键名和字符串值都必须用双引号包裹
- 不能有多余逗号、换行或 Unicode BOM(用 VS Code 自己新建并保存,别用记事本)
- 如果目录不存在(比如首次使用),先运行
mkdir -p ~/.config/Code/User(Linux/macOS)或手动创建对应文件夹(Windows)
改完不生效?大概率是进程没杀干净
VS Code 启动时读取 locale.json,但若后台进程还在,新配置不会加载。必须彻底退出:
- Windows:打开任务管理器,结束所有
Code.exe进程 - macOS:活动监视器中结束
Electron和Code Helper进程 - Linux:运行
pkill -f "Code Helper\|Electron"
再全新启动 VS Code,右下角状态栏会显示 zh-cn —— 这才是真生效。菜单栏、设置页导航栏、搜索框占位符变成中文,才算通过验证。


















