必须执行configure display language命令并选zh-cn,否则插件无效;locale.json是唯一生效配置,路径为$home/.config/code/user/locale.json,内容仅允许{"locale":"zh-cn"}(utf-8无bom、小写短横线、无空格),remote-ssh/wsl需在远程端单独配置。

统信UOS下VSCode中文界面不生效,90% 是因为 locale.json 文件路径错、内容错、编码错,或没关干净进程——装对语言包只是前提,不是充分条件。
为什么改了 settings.json 里的 locale 没用
settings.json 中写 "locale": "zh-cn" 完全无效。VS Code 自 1.70 版本起已废弃该字段,既不报错也不读取,纯属静默忽略。
- 唯一被识别的配置文件是
locale.json,且必须放在用户数据目录下的User/子目录中 - 路径错误常见于:误放至项目根目录
.vscode/下、或放到了~/.vscode/(这是旧版路径,新版已弃用) - Windows 用户易错填成
%USERPROFILE%\AppData\Roaming\Code\User\locale.json,但实际应为%APPDATA%\Code\User\locale.json(二者等价,但前者容易手误多写)
locale.json 文件必须满足的硬性条件
哪怕只有一处不满足,VS Code 就会静默回退到英文,且不提示任何错误。
- 文件名必须是
locale.json(大小写敏感,不能是Locale.json或locale.txt) - 内容只能是严格单行 JSON:
{"locale":"zh-cn"}(双引号、小写、短横线、无空格、无逗号、无注释) - 编码必须是 UTF-8 无 BOM——用记事本保存极易带 BOM;建议直接在 VS Code 里新建文件、粘贴后用「文件 → 另存为 → 编码 → UTF-8」手动确认
- 路径必须准确:
$HOME/.config/Code/User/locale.json(UOS 是 Linux 发行版,走此路径)
Remote-SSH / WSL 连接后仍是英文怎么办
本地配好了,远程还是英文?不是配置失败,而是 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读的是远程机器上的 locale.json,和本地完全无关。
- Remote-SSH 连接后,按
Ctrl+Shift+P输入Developer: Open User Data Folder,进入打开的目录中的User/子目录,新建或编辑locale.json - WSL 中先执行
code --list-extensions确认 Server 已启动,再进~/.vscode-server/data/Machine/(后面带哈希后缀的目录)→User/→ 编辑locale.json - 语言包也得在远程端单独安装:在远程窗口的扩展面板中搜索并安装
Chinese (Simplified) Language Pack for Visual Studio Code(发布者 Microsoft)
重启必须彻底,否则配置不加载
点「Reload Window」或只关窗口,locale.json 不会重读——语言上下文是在进程启动时一次性加载的。
- UOS 下检查后台进程:终端执行
pkill -f 'code',再运行ps aux | grep code确认无残留 - 托盘图标还在,就说明进程没退出;右键点击托盘图标,选「退出」而非「关闭窗口」
- 重启后验证:看设置页左侧导航栏是否为「用户」「工作区」,搜索框占位符是否为「搜索设置」;右下角状态栏应显示
zh-cn
最容易被忽略的是:文件编码是否真为 UTF-8 无 BOM,以及远程环境是否被当成另一个完全独立的 VS Code 实例来对待——它们不是子进程,是另一套配置体系。











