必须先安装microsoft官方中文语言包,再将locale设为"zh-cn"并彻底重启;仅装插件或仅配置locale均无效,且locale值必须小写、带短横线、双引号包裹,后台进程残留会导致配置不生效。

必须先装官方语言包,再设 locale 值
VS Code 不会因为系统语言是中文就自动切界面,也不靠插件“启用”就生效——Chinese (Simplified) Language Pack for Visual Studio Code 只是提供翻译资源文件,它本身不触发切换。真正起作用的是 locale 字段的值,而这个值只有在语言包存在时才被识别。所以顺序不能颠倒:没装包,设 "locale": "zh-cn" 会被忽略;只装包不设 locale,界面永远是英文。
安装插件时认准 Microsoft 官方 ID
搜索框里必须严格输入全名:Chinese (Simplified) Language Pack for Visual Studio Code。第三方插件名字相似但发布者不是 Microsoft、ID 不是 ms-ceintl.vscode-language-pack-zh-hans 的,一律跳过。这些仿冒包常见问题包括:
- 安装后右下角无弹窗提示「Restart Now」
- 执行
Configure Display Language命令时列表里没有zh-cn - 改完
locale.json后菜单仍是英文,且任务管理器里Code.exe进程还在跑
locale 配置必须写对格式且彻底重启
locale 值不是随便填的,大小写、连字符、引号都敏感:
- ✅ 正确:
"zh-cn"(小写,短横线,双引号) - ❌ 错误:
"zh_CN"、"zh-hans"、"Chinese"、"zh"、zh-cn(缺引号)
改完 locale.json 或 settings.json 后,必须做到:
- Windows:在任务管理器中确认所有
Code.exe和Code Helper进程已结束 - macOS:用活动监视器搜
Electron,全部退出 - Linux:运行
pkill -f "code"再启动
只点「Reload Window」或关窗口不杀进程,新窗口仍继承旧环境,汉化不会生效。
验证时只看三个核心区域,别被局部英文骗了
顶部菜单栏(文件、编辑、视图)、命令面板提示(请输入命令或搜索设置)、设置界面导航栏(用户、工作区、搜索框占位符)这三处全变中文,才算成功。其余如终端输出、Git 提示、调试控制台、某些插件弹窗,天生不走 VS Code 的 locale 链路,显示英文是正常现象,跟汉化配置无关。
最容易被忽略的是后台进程残留和 locale 值大小写错误——这两个点卡住,整个流程就停在英文界面不动。











