vs code 1.70+ 必须通过用户数据目录下的 locale.json 文件配置界面语言,settings.json 中的 "locale" 已被彻底弃用;文件需置于对应系统路径、内容为 {"locale":"zh-cn"}、utf-8 无 bom 编码,并重启窗口生效。

直接改 locale.json 是唯一生效方式
VS Code 1.70+ 版本已彻底弃用 settings.json 中的 "locale": "zh-cn" 配置,无论你写得多标准,它都会被静默忽略。真正起效的只有独立的 locale.json 文件,且必须位于用户数据目录下对应位置。这不是“推荐做法”,是硬性要求——没这个文件,或路径错、内容错、编码错,中文界面就不可能出现。
怎么快速打开并编辑 locale.json?
别手动拼路径,也别指望 Ctrl+, 能跳过去。最稳路径是命令面板直击目标:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language(注意大小写和空格,不能输成configure language或set locale) - 回车后会自动检查语言包,若未安装则跳转扩展页;已安装则直接打开
locale.json并预填好{"locale":"zh-cn"} - 保存后右下角弹出提示,必须点
Reload Window—— 不是关掉重开,也不是Ctrl+R刷新页面
常见失败原因:locale.json 没写对地方
很多人改完还是英文,问题不在操作,而在文件落点错误:
-
locale.json必须放在用户级目录,不是工作区目录(.vscode/locale.json已明确不生效) - Windows 正确路径:
%APPDATA%\Code\User\locale.json - macOS 正确路径:
~/Library/Application Support/Code/User/locale.json - Linux 正确路径:
~/.config/Code/User/locale.json - 文件内容只能是标准 JSON:
{"locale":"zh-cn"},不能多空格、不能带注释、不能用单引号、不能是 UTF-8 with BOM
Remote-SSH / WSL 环境要单独配
本地设好了,连上远程机器还是英文?因为 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它完全不读你本地的配置:
- 连上 Remote-SSH 后,在远程端再执行一次
Configure Display Language命令 - 或运行
Developer: Open User Data Folder,进User目录手动建/改locale.json - WSL 中需确认
code --list-extensions是否已触发 Server 启动,再找~/.vscode-server/data/Machine/xxx/User/locale.json - 语言包也要在远程环境里单独安装,不会自动同步
最容易被忽略的是:locale.json 生效依赖完整重启上下文,哪怕只漏掉一个后台 Code Helper 进程,旧语言缓存就可能继续生效。关窗口后务必检查任务管理器或活动监视器,确保无残留进程。











