locale.json是唯一生效的语言配置文件,vscode 1.80+已弃用settings.json的"locale"字段和configure display language命令,必须将{"locale":"zh-cn"}严格写入用户级或工作区级指定路径的locale.json,且需彻底退出vscode进程才生效。

locale.json 是唯一生效的语言配置文件
VSCode 1.80+ 版本已完全弃用 settings.json 中的 "locale" 字段,也不再响应 Configure Display Language 命令。界面语言只由 locale.json 决定,且该文件必须放在用户级或工作区级指定路径下,内容为合法 JSON:{"locale":"zh-cn"}。其他任何位置、格式或字段名(如 language、uiLanguage)均无效。
路径和写法必须严格匹配标准
写错路径或值会导致静默失效——VSCode 不报错,也不提示,只是继续用上一次缓存的语言。
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
~/Library/Application Support/Code/User/locale.json - Linux 路径:
~/.config/Code/User/locale.json - 值必须小写、BCP 47 标准:用
"zh-cn",不用"zh_CN"、"zh"或"zh-china" - JSON 必须无 BOM、无注释、无尾逗号、引号为英文双引号
工作区设置会覆盖用户级 locale.json
如果你在某个项目里执行过语言切换,VSCode 可能已在项目根目录生成了 .vscode/locale.json。这个文件优先级高于用户级配置,哪怕你改了全局 locale.json,只要该项目打开,界面仍按工作区设定显示。
审查 Next.js App Router 代码库,检查 React Server Component 边界错误、请求瀑布、客户端/服务端反模式以及 Core Web Vitals 风险...
- 检查是否存在:
.vscode/locale.json(注意是项目根目录下的隐藏文件夹) - 删除它即可解除覆盖;或编辑它,确保其
"locale"值符合当前需求 - Remote-SSH / WSL 场景下,远程端也有独立的
locale.json,需单独处理
改完必须彻底退出 VSCode 才能生效
Developer: Reload Window 不重载语言配置,只刷新 UI 状态和扩展上下文。语言变更需要 Electron 主进程重启,因此必须关闭所有窗口并杀掉后台进程:
- Windows:任务管理器中结束所有
Code.exe - macOS:活动监视器搜索
Electron,强制退出 - Linux:运行
pkill -f 'code' - 托盘图标还在,就说明没关干净
最容易被忽略的是环境变量干扰:如果系统或启动脚本设置了 VSCODE_LOCALE=zh-cn 或 --locale=zh-cn,它会压倒 locale.json 的配置。验证前先检查终端输出:echo $VSCODE_LOCALE(macOS/Linux)或 echo %VSCODE_LOCALE%(Windows)。










