VSCode中文界面需严格配置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"}(UTF-8无BOM、无空格、无注释、无尾逗号);必须彻底退出所有VS Code进程后创建或修改,Remote-SSH/WSL需单独配置远程端对应路径下的locale.json。

locale.json 文件路径必须严格匹配系统平台
VS Code 只在固定路径下读取 locale.json,写错一个字符(比如多斜杠、少目录、大小写混淆)都会导致文件被完全忽略。它不报错,也不提示,只是静默维持英文界面。
- Windows:
%APPDATA%\Code\User\locale.json(注意%APPDATA%是环境变量,实际路径类似C:\Users\用户名\AppData\Roaming\Code\User\) - macOS:
~/Library/Application Support/Code/User/locale.json(~代表当前用户主目录) - Linux:
~/.config/Code/User/locale.json
别把文件丢进 settings.json 所在目录的上层或同级,也别放进插件目录、缓存目录或远程服务器的本地配置里——只有这个确切路径才生效。
内容格式只允许一行标准 JSON
locale.json 不是配置模板,不是可扩展文件,它只接受且仅读取一个字段:locale,值必须是小写 zh-cn。任何额外内容都会让 VS Code 拒绝加载。
- ✅ 正确写法:
{"locale":"zh-cn"}(无空格、无换行、无注释、无 BOM) - ❌ 常见错误:
{"locale": "zh-cn"}(引号内前后有空格)、{"locale":"zh_CN"}(下划线)、{"locale":"zh-cn",}(末尾逗号)、{"locale":"zh-cn"}//注释 - 编码必须是 UTF-8 无 BOM;用记事本保存时选“UTF-8”,别选“UTF-8-BOM”或“ANSI”
创建前必须彻底退出所有 VS Code 进程
如果后台还有 Code.exe(Windows)、Code Helper(macOS)或 code 进程在运行,新写的 locale.json 可能被锁住、覆盖或延迟读取,导致重启后仍是英文。
- Windows:打开任务管理器 → 结束所有名称含
Code的进程(包括后台进程) - macOS:活动监视器 → 搜索
Code→ 全部退出 - Linux:终端执行
pkill -f code或手动检查ps aux | grep code - 确认托盘图标已消失,再新建/编辑文件
Remote-SSH 和 WSL 需要单独配 locale.json
你在本地设好了中文,但连上 Remote-SSH 或 WSL 后菜单还是英文?不是同步失败,而是远程实例根本不读你本地的 locale.json。它有自己的配置路径,且和本地完全隔离。
- 先在远程终端中确认 VS Code Server 已启动:
code --list-extensions - 进入远程机器上的路径:
~/.vscode-server/data/Machine/(后面通常带一串哈希目录名,找最新修改时间的那个) - 在该目录下新建
locale.json,内容同样严格为:{"locale":"zh-cn"} - 保存后,在**远程窗口内**执行
Developer: Reload Window,不是本地窗口
真正容易被忽略的是:VS Code 主界面语言只控制菜单、活动栏、设置页这些 UI 元素;终端、调试控制台、Git 输出、部分插件界面默认走各自语言环境,它们显示英文≠汉化失败。


















