vscode界面不会因安装语言包自动变中文,必须安装官方语言包、执行configure display language命令并重启窗口三步缺一不可;settings.json中"locale"配置自1.70起已弃用,仅用户级locale.json生效,且值必须严格为"zh-cn"。

VSCode 界面不会因为装了语言包就自动变中文,必须完成「安装官方语言包 + 执行 Configure Display Language 命令 + 重启窗口」三步闭环,缺一不可;任何跳过命令面板、直接改 settings.json 的做法在 VSCode 1.70+ 版本中已完全失效。
为什么 settings.json 里写 "locale": "zh-cn" 没用
VSCode 自 1.70 起彻底弃用了 settings.json 中的 locale 配置项。你加了这行,它既不报错也不生效,只是静默忽略。真正起作用的是独立的 locale.json 文件,且必须由 VSCode 自己生成或通过命令触发写入——否则路径错、编码错、格式错,全白搭。
- 常见错误:手动新建
settings.json并塞入"locale"字段,保存后重启仍英文 - 更隐蔽的坑:把
locale.json放在工作区目录(.vscode/locale.json),它根本不被读取 - 正确位置只有一处:
%APPDATA%\Code\User\locale.json(Windows)、~/Library/Application Support/Code/User/locale.json(macOS)、~/.config/Code/User/locale.json(Linux)
Configure Display Language 命令必须选 zh-cn,不是其他任何写法
这个命令弹出的列表里,唯一有效的选项是 zh-cn(全小写、短横线、无空格)。写成 zh_CN、zh-hans、Chinese、zh 或大小写混用,都会导致回退到英文,且无提示。
- 命令触发后,VSCode 会自动检查是否已安装语言包;没装就跳转扩展页,装完再打开
locale.json并预填好值 - 它还会确保文件落在用户级配置目录,避免你手写错路径
- 选完别只点
Enter,一定要等右下角弹出 “需要重启窗口” 提示,并点击Reload Window(不是关掉重开,也不是Ctrl+R)
装错扩展是中文不生效的最常见原因
搜索 “Chinese” 会出现一堆第三方“汉化插件”,但只有 Microsoft 官方发布的 Chinese (Simplified) Language Pack for Visual Studio Code(ID:ms-ceintl.vscode-language-pack-zh-hans)才有效。其他名字带“中文”“Pro”“Ultimate”的包,要么不更新,要么乱码,甚至注入广告。
- 安装时认准蓝白 VS Code logo + 中文“中”字图标 + Microsoft 签名
- 安装完成后,**不要点扩展页右上角的 “Reload” 按钮**——它只重载扩展逻辑,不刷新界面语言
- 如果扩展市场搜不到该包,说明 VSCode 版本低于 1.13,需先升级
部分界面仍是英文?先查后台进程和远程环境
菜单、设置页、命令面板变中文了,但 Git 面板、调试控制台、某插件 WebView 仍是英文,大概率不是语言包问题,而是环境残留或覆盖。
- 最常被忽略的是“没关干净”:Windows 任务管理器里仍有
Code.exe或Code Helper进程;macOS 活动监视器里残留 Electron 进程——新窗口会复用旧环境,看起来像没生效 - Remote-SSH / WSL 场景下,语言包和
locale.json必须在远程环境中也执行一遍 - 某些插件(如
GitLens)有独立语言设置,需单独检查其配置项,例如gitlens.language
真正卡住人的往往不是操作步骤,而是没意识到 VSCode 的语言切换依赖两个严格分离的组件:一个是资源包(语言包),一个是开关信号(locale.json 中的精确值);两者都得对,还得让进程彻底重启,中间任何一个环节松动,中文就出不来。











