必须通过configure display language命令触发写入{"locale":"zh-cn"}到locale.json并点restart生效,右下角显示zh-cn才是唯一验证点;远程开发需在远程机器对应路径手动配置,插件汉化需作者显式支持。

VSCode界面语言切换必须走Configure Display Language命令
装完Chinese (Simplified) Language Pack for Visual Studio Code(ID:ms-ceintl.vscode-language-pack-zh-hans)后界面仍是英文,不是插件没装好,而是 VS Code 运行时根本没读取新语言包。它不自动激活,必须手动触发 locale 配置写入。
常见错误包括:按Ctrl+Shift+P输错命令名(比如输成Configure Language或Change Language)、选了zh-cn但只点Reload Window、状态栏右下角仍显示en。
-
Configure Display Language是唯一能写入locale.json的官方入口,输错一个字母就找不到 - 选
zh-cn时注意连字符和小写——zh_CN、ZH-CN、zh-hans全无效 - 必须点
Restart按钮,Reload Window不重启主进程,locale 不重载 - 重启后看右下角状态栏是否显示
zh-cn,这是唯一可信验证点
远程开发(SSH/WSL)中文失效,要改远程机器上的locale.json
本地设成中文,远程窗口还是英文?这不是 bug,是 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它完全不读本地配置,只读自己所在机器上的locale.json。
路径不是~/.vscode/extensions/...,也不是用户目录下的settings.json,而是 Server 数据目录里的Machine/xxx/locale.json。
- 先在远程终端执行
code --list-extensions确认 Server 已启动 - 进入
~/.vscode-server/data/Machine/(后面可能带哈希后缀),在此目录下新建或编辑locale.json - 内容仅一行:
{"locale":"zh-cn"},编码必须为 UTF-8 无 BOM - 改完后,在远程窗口中执行
Developer: Reload Window(不是本地窗口)
插件自身中文支持不靠语言包,得看package.json里有没有zh-cn配置项
即使 VS Code 界面已汉化,插件设置页、命令提示、配置项描述仍可能是英文——这不是语言包没生效,而是插件作者没在package.json的contributes.configuration里为每个title和description显式声明zh-cn键值对。
比如你看到"myPlugin.enable": true在settings.json里,但设置面板中标题仍是“Enable My Plugin”,说明插件没做 locale 适配。
- 插件汉化 ≠ VS Code 汉化,两者配置完全隔离
-
package.nls.zh-cn.json只能翻译插件内硬编码字符串,不能覆盖contributes.configuration里的文案 - 部分插件(如
Tailwind CSS Intellisense ≥ v0.10.0)已内置简体中文,但需检查版本号 - 若某插件中文乱码,优先查其扩展目录下是否存在
package.nls.zh-cn.json且未被覆盖
手动改locale.json是最稳的兜底方案,但路径和格式必须精准
当命令面板打不开、快捷键失灵、反复切换无效时,直接编辑配置文件是最可靠的 fallback 方式。但 90% 的“改了没反应”都源于改错文件或格式错误。
别碰settings.json,VS Code 2026 版本已完全忽略其中的locale字段;也别往扩展目录里塞配置,那根本不被加载。
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
~/Library/Application Support/Code/User/locale.json - Linux 路径:
~/.config/Code/User/locale.json - 文件内容必须严格为:
{"locale":"zh-cn"}(JSON 合法、无多余逗号、无空格、UTF-8 无 BOM) - 改完后必须彻底关闭所有 VS Code 进程(Windows 查任务管理器中的
Code.exe,macOS 查Electron),再启动











