wsl中vscode界面仍英文,需在wsl侧~/.vscode-server/data/machine/locale.json(或旧版对应路径)创建/编辑文件,内容为{"locale":"zh-cn"},并确保中文语言包已安装激活。

WSL 中 VSCode 界面仍是英文?locale.json 必须放在远程侧
VS Code 在 WSL 里启动的不是本地客户端,而是独立的 VS Code Server 进程,它完全不读取 Windows 侧的 locale.json 或 settings.json。你本地设成中文,WSL 里照样显示英文——这不是 bug,是设计如此。
必须手动在 WSL 的用户目录下创建或确认该文件路径:~/.vscode-server/data/Machine/locale.json(VS Code 1.85+ 默认位置)或旧版的 ~/.vscode-remote/data/Machine/locale.json。
- 内容只能是严格合法的 JSON:
{"locale":"zh-cn"},不能有注释、多余空格、单引号或写成zh_CN/zh-hans - 文件不存在就新建;存在但值不对就直接编辑保存,无需重启 WSL 或 VS Code Server
- 如果 WSL 使用非标准 home 目录(比如挂载在
/mnt/d/home),要确认~指向的是真实用户主目录,否则 locale.json 会被静默忽略
为什么装了中文语言包,WSL 里还是部分英文?别指望插件自动同步
Remote-SSH 和 WSL 都不会把本地已安装的 MS-CEINTL.vscode-language-pack-zh-hans 自动复制过去。VS Code Server 内置语言资源,但只在 locale.json 正确触发时加载。
验证是否生效:连接 WSL 后,按 Ctrl+Shift+P 输入 Developer: Show Running Extensions,检查列表中是否有状态为 Activated 的 ms-ceintl.vscode-language-pack-zh-hans。
- 如果没有,大概率是
locale.json路径错或内容非法;可临时在 WSL 终端执行:code --install-extension MS-CEINTL.vscode-language-pack-zh-hans --force强制注册(仅调试用) - 右键菜单、调试控制台、部分扩展 UI 默认未汉化,这是官方语言包的正常覆盖范围(约 85%),不是配置失败
- 某些 Snap/Flatpak 安装的 VS Code 在 WSL 下无法加载语言包,建议改用官方
.deb或 tarball 版本
Configure Display Language 命令在 WSL 里点不了?说明语言包根本没装上
这个命令只在语言包成功激活后才出现在命令面板里。如果你在 WSL 窗口中搜不到 Configure Display Language,说明 MS-CEINTL.vscode-language-pack-zh-hans 没被 Server 加载,不是“忘了点”,而是压根没就位。
- 先确认 WSL 中已运行
code --list-extensions | grep zh-hans,输出应包含ms-ceintl.vscode-language-pack-zh-hans - 若无输出,手动执行:
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans - 装完后不要点 “重载窗口”,必须关闭当前 WSL 窗口,再从 VS Code 远程资源管理器里重新连接一次
- 状态栏右下角显示
en就代表未生效,此时点击它弹出的语言菜单,选zh-cn是最快兜底方式(它会自动写入正确的locale.json)
Windows 和 WSL 的 locale.json 写法一样,但位置和生效逻辑完全不同
Windows 本地的 locale.json 在 %APPDATA%\Code\User\locale.json,而 WSL 的必须在 ~/.vscode-server/data/Machine/locale.json。两个文件内容都是 {"locale":"zh-cn"},但互不干扰、不可复用。
最容易被忽略的一点:WSL 启动时会按固定顺序查找 locale.json,一旦某个路径存在但内容非法(比如多了一个逗号),它就会跳过并 fallback 到英文,且不报错、不提示。
- 别往
.vscode工作区目录下放locale.json——2026 年 4 月 17 日起已明确不生效 - 别在
settings.json里写"locale": "zh-cn"——VS Code 1.70+ 完全忽略该字段 - 每次换 WSL 发行版(比如从 Ubuntu-20.04 升级到 22.04),
.vscode-server目录可能重建,locale.json需要重新部署











