locale.json是唯一生效配置,settings.json中写locale完全无效;必须置于用户数据目录对应路径,内容严格为{"locale":"zh-cn"}(UTF-8无BOM、小写短横线、无空格/注释/多余字段),且需彻底退出VS Code进程后重启方可生效。

locale.json 是唯一能强制生效的配置方式,settings.json 里写 locale 完全无效。
locale.json 文件必须放在正确路径
VS Code 只读这个文件,且只在用户数据目录下找它。路径错一个字符、多一层嵌套、或用了中文用户名,都会静默失败。
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
注意:%APPDATA% 和 ~ 是系统变量,别手动替换成具体路径;如果路径中含空格或中文,务必重装 VS Code 到纯英文路径下再试。
内容格式必须严格合法
哪怕多一个空格、用全角引号、带 BOM 头,VS Code 就当文件不存在,直接回退英文。
- 文件内容只能是单行 JSON:
{"locale":"zh-cn"} - 双引号必须是半角,
zh-cn必须小写、连字符、不能写成zh_CN或ZH-cn - 不能有逗号结尾,不能有注释,不能有其他字段(如
"foo": "bar") - 保存时选“UTF-8 无 BOM”,用 VS Code 自己新建并保存最保险;别用记事本、Sublime 或某些编辑器默认编码
必须彻底退出 VS Code 才能生效
右上角关窗口 ≠ 进程退出。残留的 Code.exe(Windows)或 Code Helper(macOS)会继续读旧配置,导致改了也白改。
- Windows:打开任务管理器,杀光所有
Code.exe和Code Helper进程 - macOS:活动监视器里搜
Code,结束全部相关进程 - Linux:终端执行
pkill -f "code" - 重启后,立刻检查顶部菜单栏文字、设置页左侧导航是否为“用户”“工作区”,这是真生效的标志
真正容易被忽略的是:远程开发(如 Remote-SSH、WSL)需要单独配一份 locale.json,放在远程机器对应路径下,本地改了对远程实例完全没影响。


















