最可靠方式是安装官方中文语言包、执行Configure Display Language命令选zh-cn、重启窗口;直接改settings.json无效,因1.70+已弃用该配置,须由命令自动生成locale.json。
立即进入“java入门到进阶,资料速存!☜☜☜☜☜点击进入”;

VSCode 设置中文界面最可靠的方式,是安装官方语言包 + 用 Configure Display Language 命令设置 zh-cn,然后重启——这三步做完,99% 的情况都能生效;别信“改 settings.json 就行”或“装完插件自动变中文”的说法,那些要么过时,要么漏关键动作。
为什么直接改 settings.json 不管用
VS Code 从 1.70 版本起已弃用 settings.json 中的 "locale": "zh-cn" 配置项。如果你在 settings.json 里手动加了这行,它会被完全忽略,VS Code 启动时甚至不报错,只是静默跳过。真正起效的是独立的 locale.json 文件,且必须由 VS Code 自己生成或通过命令触发编辑。
常见错误现象包括:
- 改完
settings.json保存后重启,界面仍是英文 - 搜索设置里能看到 “Locale” 选项,但它是只读的,点不了
- 误把
locale写成locale.language或app.language等不存在字段
用 Configure Display Language 命令才是正解
这个命令会自动检查是否已安装对应语言包,没装就跳转扩展页,装完再打开 locale.json 并预填好 "locale": "zh-cn",路径也确保落在用户级配置目录(如 %APPDATA%\Code\User\locale.json 或 ~/.config/Code/User/locale.json),避免你手写错位置。
操作步骤很明确:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language,选中并回车 - 在弹出列表中选择
zh-cn(不是zh-CN或Chinese (Simplified)) - 看到提示“语言包未安装”,就点 Install;已安装则直接保存
locale.json - 点击右下角弹出的 Reload Window,不是关掉重开,也不是 Ctrl+R 刷新
Reload Window 失败的三个典型原因
很多人点了 Reload Window 还是英文,不是命令错了,而是被环境干扰了:
-
locale.json被写到了工作区目录(.vscode/locale.json)而不是用户目录:工作区级配置只对当前文件夹生效,且优先级低于用户级,容易被覆盖 - 从终端启动 VS Code(比如用
code .):某些 Linux/macOS 终端会把$LANG或$LC_ALL值透传给 VS Code,强行覆盖locale.json设置 - 多账户或 WSL 场景下,编辑了远程连接的
locale.json:本地中文设置不会同步到 WSL 或 SSH 远程窗口,得分别配置
验证是否成功:打开命令面板(Ctrl+Shift+P),看提示框顶部文字是不是“请输入要执行的命令”,而不是“Type the name of an action to run”。这才是真·中文生效的标志。
部分界面仍是英文?不是设置失败,是扩展没翻译
菜单栏、侧边栏、状态栏、设置页这些核心 UI 变成中文,说明你的设置完全正确。但如果你看到某个扩展的右键菜单、弹窗标题、或调试面板里的按钮还是英文,那和 VS Code 本身无关——是那个扩展没提供中文语言包,或者作者没调用 vscode.l10n API 做国际化。
这种情况无法通过改 locale.json 解决,只能:
- 检查该扩展是否声明支持
zh-cn(看其package.json的contributes.localizations字段) - 去 GitHub 提 issue,附上截图和语言包版本号
- 临时方案:禁用该扩展,或换一个有中文支持的同类替代品
真正容易被忽略的点是:VS Code 的语言切换不是“全有或全无”,它分三层(用户 > 工作区 > 远程),而每个扩展又自带一套本地化逻辑——你以为设了一次就万事大吉,其实只是开了个头。


















