vscode界面未变中文主因是locale.json配置错误:路径必须为用户级目录(如windows的%appdata%\code\user\locale.json),内容仅允许{"locale":"zh-cn"},且须通过configure display language命令生成并重启生效。

VSCode 界面没变中文,90% 是 locale.json 没配对——不是插件没装,也不是重启错了,而是这个文件的位置、内容或生成方式出了问题。
locale.json 文件路径必须严格匹配
VS Code 只读取用户级目录下的 locale.json,其他位置写的都无效。它不看工作区设置,也不继承系统路径。
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
常见错误:把文件放到 .vscode/ 下、放到项目根目录、或误存为 locale.json.txt;也有人写成 Code - Insiders 或 Code - OSS 目录,那属于另一个 VS Code 实例,主编辑器根本不会读。
locale.json 内容只允许一行合法 JSON
这个文件不是配置项,是开关——VS Code 启动时只解析它,且格式错一个字符就静默回退英文。
- 正确内容(仅且必须):
{"locale":"zh-cn"} - 错误示例:
{"locale": "zh_CN"}(下划线不行)、{"locale":"zh-CN"}(大写 C/N 不行)、{"locale":"zh-hans"}(VS Code 不认)、{"locale":"zh-cn",}(末尾逗号非法) - 不能有注释、不能多字段、不能用中文引号、不能带 BOM 头——用 VS Code 自己新建并保存为 UTF-8 无 BOM 最稳
Configure Display Language 命令才是唯一可信入口
手动创建或编辑 locale.json 容易出错,而 Configure Display Language 命令会自动校验语言包是否存在、写入标准路径、确保 JSON 合法,并触发后续流程。
- 必须从命令面板(
Ctrl+Shift+P或Cmd+Shift+P)输入完整命令名,大小写和空格都不能错 - 列表里选的是
zh-cn,不是 “简体中文” 文字项,也不是zh或zh-TW - 弹窗提示后必须点 Restart,点 “Don’t Restart” 或只关窗口再开,进程残留会导致配置不加载
远程开发或插件调试时 locale.json 不共享
Remote-SSH、WSL、Dev Container 和 Extension Development Host 都是独立实例,它们各自读自己的 locale.json,和本地完全无关。
- Remote-SSH 连上后,需在远程终端里执行
code --list-extensions确认中文包已安装,再在远程窗口中运行Configure Display Language - 插件调试时的开发宿主窗口(F5 启动的那个),默认不继承主编辑器语言,可在
launch.json中加"runtimeArgs": ["--locale=zh-cn"]强制生效 - 别把本地的
locale.json复制进插件项目目录——vsce package会把它一起打包,导致发布失败
最常被忽略的是:右下角状态栏显示 en 就说明没生效,此时别猜原因,直接打开对应路径确认文件存在、内容合法、编码无 BOM,再查有没有进程残留——这三个点卡住,其他操作都是白忙。











