vs code装完中文语言包仍英文,主因是未执行configure display language命令生成正确locale.json;必须手动输入该命令、选zh-cn、彻底重启,且remote-ssh/wsl需单独配置远程locale.json。

装完中文语言包却还是英文界面,不是插件没装对,而是 locale.json 没写对、没生效,或根本没生成——这是 90% 自学者卡住的第一步。
Configure Display Language 命令必须手动执行
VS Code 不会自动激活语言包。安装 Chinese (Simplified) Language Pack for Visual Studio Code 后,界面不变是正常现象;它只加载翻译资源,不修改运行时语言配置。
真正起效的操作只有这一步:
- 按
Ctrl+Shift+P(macOS 是Cmd+Shift+P)打开命令面板 - 输入完整命令名:
Configure Display Language(注意不是 “Change Language” 或 “Configure Language”) - 从下拉列表中**滚动找到并选中
zh-cn**(不是“简体中文”文字,是那个带短横线的小写代码标识符) - 点 Restart —— 不是
Developer: Reload Window,必须彻底重启进程
执行后,VS Code 会自动生成或覆盖用户级 locale.json 文件,内容为 {"locale": "zh-cn"}。如果文件已存在但含其他字段(比如 "theme"),整行都会被忽略。
Remote-SSH / WSL 环境中文不生效?本地设置完全无关
你在本地设成中文,远程窗口仍是英文,这不是 bug,是 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读取的是远程机器上的 locale.json,和本地配置毫无关系。
操作路径如下:
- 先确认远程 Server 已启动:在远程终端执行
code --list-extensions - 进入远程路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀) - 在此目录下新建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"},编码必须为 UTF-8 无 BOM - 回到远程 VS Code 窗口,执行
Developer: Reload Window(不是 reload 本地窗口)
Windows/macOS/Linux 的本地 locale.json 路径对远程无效,别白改。
Settings Sync 同步后中文消失?locale.json 不在同步范围内
Settings Sync 只同步 settings.json、快捷键、扩展列表等,locale.json 被明确排除在外。所以同步完成后界面变英文,不是“被覆盖”,而是你本地的 locale.json 为空或仍为 {"locale":"en"},而 Sync 根本没把它拉回来。
验证与修复方法:
- 执行
Configure Display Language,检查它打开的locale.json是否真为{"locale":"zh-cn"} - 如果不是,直接编辑该文件,删掉所有多余内容,只留那一行 JSON
- 路径要对:Windows 是
%APPDATA%\Code\User\locale.json,macOS 是~/Library/Application Support/Code/User/locale.json,Linux 是~/.config/Code/User/locale.json - 同步后新设备上务必走一遍这个流程,不能只靠登录账号就以为万事大吉
很多人在公司电脑上看到中文,在家里的笔记本上却是英文,问题就出在这里:两台机器的 locale.json 物理存在性不一致。
插件界面仍是英文?这不是配置问题,是插件没做适配
VS Code 官方语言包只控制菜单、设置页、命令面板等主 UI,不负责插件界面。插件是否显示中文,取决于它自己有没有提供 package.nls.zh-cn.json 并调用 vscode.env.language 加载。
常见情况:
-
Prettier、ESLint、GitLens(旧版)基本无中文配置项说明,即使 locale 是zh-cn,也显示英文 -
Tailwind CSS Intellisense≥ v0.10.0 才内置简体中文支持(2026 年 6 月后发布) -
Chinese Menu这类第三方汉化插件已多年未更新,在 VS Code 1.80+ 上易引发右键菜单错乱甚至设置页白屏
验证方式很简单:打开插件的设置页(扩展图标 → 找到插件 → 齿轮 → Extension Settings),看标题和描述是不是中文。不是?那就说明它没做本地化,换 locale 或重装语言包都没用。
最常被忽略的一点:改完 locale.json 后,插件不会自动刷新语言——它们通常只在激活时读一次 vscode.env.language。不彻底重启 VS Code,很多插件界面仍沿用旧值。











