VSCode中文界面“永久保留”常失效,根本原因是locale.json未满足三条件:位置正确、内容合法JSON、VSCode彻底重启;Remote-SSH/WSL需单独配置远程端locale.json并安装中文语言包。

为什么“永久保留”常失效
VSCode 中文界面不是一次设置就一劳永逸的事。很多人装完语言包、切到 zh-cn,过几天打开又变英文——根本原因在于:VSCode 启动时会读取 locale.json,但这个文件可能被覆盖、被忽略,或压根没写对位置。更常见的是,你改了本地配置,却忘了 Remote-SSH / WSL 的远程端也得单独配。
确保 locale.json 生效的三个硬性条件
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"}(注意小写、连字符、无多余空格或逗号) - VSCode 必须彻底退出再启动:Windows 要杀掉所有
Code.exe和Code Helper进程;macOS/Linux 要确认没有残留 Electron 进程
Remote-SSH / WSL 下中文不保留?那是远程端没配
本地 locale.json 写得再标准,对远程 VS Code Server 也没用。它有自己的用户数据目录,不会继承本地设置:
- Remote-SSH 连接后,按
Ctrl+Shift+P→ 输入Developer: Open User Data Folder→ 进入User目录,新建或编辑locale.json - WSL 中执行
code --list-extensions确认 Server 已启动,然后进~/.vscode-server/data/Machine/xxx/User/locale.json(xxx是哈希值目录) - 远程端同样要安装
Chinese (Simplified) Language Pack扩展,否则{"locale":"zh-cn"}会被静默忽略
容易被忽略的“永久性破坏点”
你以为配好了,其实几个操作正在悄悄抹掉你的设置:
- 误点“重新加载窗口”(
Developer: Reload Window):它不重读locale.json,也不触发语言切换逻辑 - 用命令行启动时加了
--locale=en或其他参数:会临时覆盖locale.json,且部分场景下会写回配置 - 企业设备受组策略限制:Windows 注册表项
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced\PreferredUILanguages被锁定,VSCode 会强制 fallback 到英文 - 手动在
settings.json里写了"locale": "zh-cn":这个字段完全无效,VSCode 会直接忽略
真正“永久”的关键,是让 locale.json 在正确位置、以正确内容、被正确进程读取——其余任何捷径,包括命令面板里的旧版 Configure Display Language(1.80+ 已移除),都不再可靠。











