vscode 中文界面需同时安装官方语言包、执行 configure display language 命令设为 zh-cn、彻底重启所有进程,三者缺一不可;终端/编译器/插件等外部输出仍为英文属正常设计。

VSCode 设置中文不是装个插件就完事,必须安装官方语言包 + 显式设置 locale + 彻底重启进程,三者缺一不可;只装不设、只设不装、或用了第三方“汉化插件”,界面大概率还是英文。
怎么装对中文语言包?认准 Microsoft 官方 ID
VSCode 的中文支持由微软维护的独立扩展提供,不是内置功能,也不是随便搜“中文”就能装对。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code—— 注意全名,别漏掉for Visual Studio Code - 确认发布者是 Microsoft,ID 是
ms-ceintl.vscode-language-pack-zh-hans - 点击 Install,完成后右下角可能弹出 “Change Language and Restart”,但先别点它——这只会改当前窗口,不生效于新窗口
Configure Display Language 命令必须执行
语言包只是“词典”,VSCode 默认不会自动调用它。必须通过命令面板显式告诉编辑器:“我要用简体中文”。
- 按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language,回车选择 - 在弹出列表中选
zh-cn(不是zh、zh-hans或zh_CN) - 看到提示 “需要重启窗口以应用更改”,点 Restart —— 这一步不能跳过,热重载无效
为什么重启后还是英文?重点检查这几个地方
多数“汉化失败”不是插件没装好,而是配置被覆盖或进程没清干净。
- 检查快捷方式或终端启动命令是否带了
--locale=en或--lang=en参数(尤其 macOS Dock 启动、Linux 脚本启动时容易残留) - 打开命令面板,再输一次
Configure Display Language,看当前选中项是不是zh-cn - 手动检查
locale.json文件是否存在且格式正确:- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json - 内容必须严格为一行:
{"locale":"zh-cn"}(无空格、无 BOM、引号和括号全英文)
- Windows:
- 杀干净后台进程再开:Windows 任务管理器结束所有
Code.exe,macOS 终端运行pkill -f "Electron.*Code",Linux 运行pkill -f "code.*--no-sandbox"
汉化后哪些还是英文?这不是 bug,是设计如此
菜单、状态栏、命令面板、设置页这些 VSCode 自己画的部分会变中文;但以下内容不受影响,也不该指望它变中文:
- 终端输出(
npm install、python、git等命令报错)—— 这些由系统 shell 或对应工具决定 - TypeScript 编译错误(如
TS2307: Cannot find module 'xxx')—— 来自tsc进程,需靠插件如TS Server Localized Messages单独支持 - Python 报错(如
ModuleNotFoundError)—— 取决于python.exe自身的 locale 配置 - 部分插件 UI(如 Copilot Chat、ESLint 插件的 WebView 页面)—— 语言由服务端或插件自身控制,
locale.json不起作用
真正卡住新手的,往往是把 VSCode 主体语言和外部工具输出混为一谈——盯着中文菜单,却在找英文报错的根源,方向就偏了。











