必须用 configure display language 命令生成 locale.json,手动创建易因编码、路径、大小写或格式错误导致失效;remote-ssh/wsl 需在对应 server 的 machine 子目录下单独配置,且升级后路径可能变化。

装了中文语言包但界面还是英文?不是插件没装对,是 VS Code 根本没“读到”你的语言偏好——它只认 locale.json 里那一行 {"locale":"zh-cn"},别的地方写什么都无效。
必须用 Configure Display Language 命令生成 locale.json
手动创建或编辑 locale.json 容易出错:编码不是 UTF-8 无 BOM、路径放错位置、大小写/连字符写成 zh_CN 或 Zh-cn 都会导致失效。VS Code 提供的 Configure Display Language 命令(Ctrl+Shift+P 输入后执行)会自动在正确路径下生成标准格式文件,并确保内容合法。
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径:
$HOME/.config/Code/User/locale.json - 文件内容只能是纯 JSON:
{"locale":"zh-cn"},多一个空格、少一个引号都不行
Remote-SSH / WSL 环境要单独配 locale.json
本地设好了,远程连接后还是英文?因为 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它不读你本地的配置,而是读远程机器上的 locale.json。
- 先在远程终端运行
code --list-extensions确保 Server 已启动 - 进入路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀目录) - 在此目录下新建
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window,不是 reload 本地窗口
右下角显示 en 就说明没生效
这不是“部分汉化”,而是整个语言上下文未加载。常见假象包括:菜单变中文了但设置页仍是英文、命令面板提示是英文、错误弹窗是英文——这些都意味着 locale.json 没被读取或内容非法。
- 检查所有 VS Code 进程是否彻底退出(托盘图标还在就代表没关干净)
- 用 VS Code 自己新建并保存
locale.json,别用记事本编辑(容易带 BOM) -
settings.json里加"locale": "zh-cn"完全无效,VS Code 不读这个字段 - 集成终端里的
gcc -v或node --version输出仍是英文属正常,它们不受 VS Code locale 控制
最容易被忽略的是:Remote-SSH 和 WSL 的 locale.json 必须放在 Server 进程实际读取的 Machine 子目录下,而不是用户主目录;而且每次 VS Code Server 升级后,那个哈希后缀目录可能变化,得重新找一次路径。











