必须安装 microsoft 官方中文语言包 ms-ceintl.vscode-language-pack-zh-hans,通过 configure display language 命令选择 zh-cn 并完全重启(杀尽后台进程),才能正确汉化 vs code 核心 ui。

安装 Microsoft 官方中文语言包必须认准 ID 和作者
装错插件是汉化失败的第一大原因。VS Code 不识别“中文”“汉化”这类模糊关键词,只认 ms-ceintl.vscode-language-pack-zh-hans 这个 ID 和作者 Microsoft。其他名称相似的插件(如 “Chinese Language Pack” 或 “VSCode Chinese”)基本是旧版、未维护或带副作用的第三方包,可能造成命令面板乱码、状态栏错位甚至崩溃。
操作时务必:
- 按
Ctrl+Shift+X打开扩展面板,粘贴全名:Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是
Microsoft,图标带蓝白 VS 标志和“中”字 - 安装后**不点“Reload Window”**,右下角弹出的
Restart Now提示必须点——这是唯一触发语言资源加载的时机
Configure Display Language 命令才是切换语言的唯一有效入口
VS Code 1.70+ 版本已彻底弃用在 settings.json 中写 "locale": "zh-cn" 的方式。这个字段现在被忽略,手动添加无效,还可能干扰自动配置流程。
正确做法只有这一条路径:
- 按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language(注意大小写和空格,不能少字母或拼错) - 从下拉列表中**严格选择
zh-cn** ——zh_CN、zh-CN、Chinese全部不识别 - 选完后弹出提示,点
Restart(不是Reload Window),VS Code 会自动生成或更新locale.json文件(路径如%APPDATA%\Code\User\locale.json或~/.config/Code/User/locale.json)
重启必须杀干净后台进程,否则 locale.json 不生效
Reload Window 只刷新渲染层,不会重新初始化语言环境。只要旧进程还在,新窗口就复用旧 locale 配置,永远显示英文。
验证是否真重启:
- Windows:打开任务管理器,确认所有
Code.exe进程已结束(包括后台的Code Helper) - macOS:活动监视器里搜
Electron或Code,全部强制退出 - Linux:终端执行
pkill -f "code"再启动 - 启动后立刻检查顶部菜单栏是否为「文件」「编辑」「视图」——这是最可靠的生效信号
验证时别被终端、Git 输出或插件界面误导
VS Code 的 locale 配置只控制核心 UI:菜单栏、命令面板(Ctrl+Shift+P 上方提示)、设置界面(Ctrl+,)、状态栏文字等。终端、调试控制台、Git 面板输出、WebView 插件内容这些区域**天生不走 locale 配置**,显示英文完全正常。
真正要盯的只有三处:
- 顶部菜单栏文字是否中文
- 命令面板输入框上方是否显示「请输入命令或搜索设置」
- 设置界面左侧导航栏是否为「用户」「工作区」「扩展」
如果这三项全是中文,说明汉化已完成。其他区域仍英文,不是配置问题,而是组件本身未适配或依赖系统语言环境。











