直接写 locale.json 是 vs code 中文界面最稳的路径,需严格匹配路径、文件名(locale.json)、内容({"locale":"zh-cn"})、utf-8无bom编码,并彻底退出重开;remote-ssh/wsl需单独配置。

直接写 locale.json 是 VS Code 中文界面最稳的路径,比命令面板更可靠——尤其当 Configure Display Language 命令卡死、搜不到、或点完没反应时。
确认路径和文件名必须严格匹配
VS Code 只读取用户级目录下的 locale.json,路径错一个字符、文件名大小写不对、或放错层级,都会静默失效。
- Windows:
%APPDATA%\Code\User\locale.json(不是%USERPROFILE%\AppData\Roaming\Code\User\的别名路径,也别用记事本默认保存的locale.json.txt) - macOS:
$HOME/Library/Application Support/Code/User/locale.json(注意Application Support有空格,User是小写) - Linux:
$HOME/.config/Code/User/locale.json(.config是隐藏目录,别漏掉点) - 文件名必须是
locale.json,不能是locale.txt、Locale.json或locale.json.bak
内容只允许一行合法 JSON,且无 BOM
VS Code 对 locale.json 内容极其敏感:多一个空格、少一个引号、用了全角字符、带 UTF-8 BOM,都会导致回退英文。
- 正确内容(仅且必须):
{"locale":"zh-cn"} - 不要加逗号、不要换行、不要注释、不要多余空格(比如
{"locale": "zh-cn"}中冒号后那个空格就可能失败) - 编码必须是 UTF-8 无 BOM —— 用 VS Code 自己新建文件并保存,能天然规避 BOM;别用 Windows 记事本或 Sublime Text 直接写
- 如果文件已存在且含其他字段(比如
{"locale":"zh-cn","foo":1}),整行会被忽略,直接删光,只留那一行
改完必须彻底退出再重开
VS Code 启动时读一次 locale.json,运行中修改不会热生效。所谓“重载窗口”(Developer: Reload Window)不重读该文件,无效。
- Windows:打开任务管理器,杀掉所有
Code.exe和Code Helper.exe进程(托盘图标还在就说明没关干净) - macOS:活动监视器里查
Electron或Code Helper,全部退出 - Linux:终端执行
pkill -f "code"或手动确认ps aux | grep code无残留 - 重开后,右下角状态栏会显示
zh-cn(点击可切换),菜单栏、设置页搜索框占位符变成“搜索设置”,即为成功
Remote-SSH 或 WSL 下要单独配——本地的 locale.json 对远程实例完全无效,得进远程机器对应路径(如 ~/.vscode-server/data/Machine/xxx/User/locale.json)再写一遍。真正容易被忽略的是:终端、调试控制台、Git 输出仍是英文,这不是配置失败,是它们走各自语言环境,和 locale.json 无关。











