VS Code 安装中文语言包后仍显示英文界面,是因为必须通过 Configure Display Language 命令选择 zh-cn 并重启,而非仅安装插件;远程开发需在远程机器的 locale.json 中配置;第三方插件中文支持取决于其自身适配。

为什么装了中文语言包还是英文界面
因为 VSCode 不会自动激活语言包,只安装 Chinese (Simplified) Language Pack for Visual Studio Code 插件只是加载翻译资源,真正生效必须靠 locale 配置透传到运行时。常见失效现象包括:右下角状态栏显示 en、设置页左侧导航仍是英文、命令面板提示为英文——这些不是插件没装好,而是 locale 没写对或没加载。
- 必须用
Configure Display Language命令(不是Configure Language或Change Language)选zh-cn(注意连字符,大小写不敏感但 2026 年起推荐小写) - 选完后必须点
Restart,仅Developer: Reload Window不够——后台Code.exe进程还在读旧 locale -
settings.json里加"locale": "zh-cn"无效;VS Code 2026 版本只认locale.json文件(路径在用户数据目录下)
远程开发(Remote-SSH / WSL)中文不生效
本地设成中文,远程窗口还是英文?这不是 bug,是 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读取的是远程机器上的 locale.json,和本地完全无关。
- 在远程终端中执行
code --list-extensions确认 Server 已启动 - 进入路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀),在此目录下新建或编辑locale.json - 文件内容仅一行:
{"locale":"zh-cn"},编码必须为 UTF-8 无 BOM(用 VS Code 自己新建保存最稳妥) - 改完后,在远程窗口执行
Developer: Reload Window,不是 reload 本地窗口
插件汉化是否同步生效
VS Code 核心界面(菜单、设置页、命令面板)由官方语言包控制,但第三方插件是否显示中文,取决于插件作者是否提供对应语言资源。比如 Prettier、ESLint、GitLens 的错误提示、配置项说明等,多数仍为英文;Path Intellisense 和 Auto Rename Tag 则基本无中文适配。
- 不要指望装完语言包后所有弹窗、报错、插件设置页都变中文——这是正常现象
- 部分插件(如
Tailwind CSS Intellisense)已内置简体中文支持,但需插件版本 ≥ v0.10.0(2026 年 6 月后发布) - 若某插件中文乱码,检查其扩展目录下的
package.nls.zh-cn.json是否存在且未被覆盖
强制汉化的兜底操作(命令面板失灵时)
当快捷键失效、命令面板打不开、反复切换无效,直接改配置文件是最稳的方案。这不是高级技巧,而是生产环境常用兜底手段。
- 按
Ctrl+Shift+P输入Open User Settings (JSON)回车,打开settings.json—— 这步只是备用入口 - 真正要改的是
locale.json:Windows 路径为%APPDATA%\Code\User\locale.json,macOS 为~/Library/Application Support/Code/User/locale.json - 手动创建该文件,内容严格为:
{"locale":"zh-cn"}(无空格、无注释、无多余字段) - 保存后,从任务管理器结束所有
Code.exe进程(Windows)或 Activity Monitor 强制退出(macOS),再双击图标重开
locale 配置看似简单,但实际涉及进程级上下文继承、远程实例隔离、文件编码细节三个容易被跳过的层面。尤其在嵌入式或 CI 环境中,漏掉任一环节都会导致中文“局部生效”——菜单是中文,但调试控制台报错仍是英文,这种割裂感反而更干扰判断。


















