必须安装官方“Chinese (Simplified) Language Pack for Visual Studio Code”(ID:ms-ceintl.vscode-language-pack-zh-hans),运行Configure Display Language选zh-cn后点Restart,或手动编辑locale.json写{"locale":"zh-cn"}并重启。

装错插件是中文不生效的最常见原因
搜“中文”“汉化”“简体中文”会出来一堆非官方包,比如 Chinese Language Pack、VSCode Chinese,它们不是 Microsoft 维护,2026 年起基本失效,还可能引发 Cannot read property 'translate' of undefined 或命令面板空白。必须严格输入全名:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- Windows/Linux 按
Ctrl+Shift+X,macOS 按Cmd+Shift+X打开扩展面板 - 搜索框里**粘贴全名**,一个空格、括号都不能少
- 只点那个带蓝白 VS Code logo + 中文“中”字图标的选项
- 安装后右下角弹出
Restart Now提示——必须点它,不是“关闭再打开”
Configure Display Language 命令只写配置,不刷新界面
语言包只是把翻译资源放进了本地,Configure Display Language 命令才是真正激活开关。但它只改 locale.json,不会自动重载 UI。很多人点了命令、选了 zh-cn,却没点提示里的 Restart,或误点了 Developer: Reload Window —— 后者只会重载插件,不加载新语言资源。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择
Configure Display Language(注意大小写和空格) - 从列表中选
zh-cn(不是zh-CN、zh_CN、zh、ZH-CN) - 弹窗出现后,必须点
Restart按钮,不能只关窗口再开
手动编辑 locale.json 是最稳的兜底方式
如果命令面板打不开、卡死,或切换后仍无效,说明 VS Code 没读到语言配置。此时直接编辑 locale.json 是唯一可靠路径——它绕过 UI 层,强制指定语言,且 2026 年起该文件是**唯一有效入口**(settings.json 里写 "locale" 已被移除)。
- 先彻底退出 VS Code:Windows 查任务管理器杀掉所有
Code.exe;macOS 在活动监视器里结束Code Helper - 打开对应路径的
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容只写一行:
{"locale":"zh-cn"} - 用 VS Code 自己打开并保存,确认右下角状态栏显示
UTF-8(不是GBK或UTF-8 with BOM)
验证是否真生效,别被假象骗了
重启后只看三个地方:顶部菜单栏(文件/编辑/视图)、命令面板提示(请输入命令或搜索设置)、设置界面左侧导航(用户/工作区/扩展)。这三处是中文,才算成功。
-
终端、调试控制台、Git 输出显示英文是正常现象——那是 shell 或调试器自己的语言环境,和 VS Code 主界面无关 - Remote-SSH / WSL 下仍是英文?那是远程实例没配,得去远程机器的
~/.vscode-server/data/Machine/xxx/locale.json单独写一遍 - 右下角状态栏如果还显示
en,直接点击它,从下拉菜单选zh-cn是最快兜底方式
Configure Language、选了 zh 而非 zh-cn、点了重载窗口没点重启——只要这四件事做对,1 分钟内就能看到中文菜单。


















