VSCode 中文界面需同时满足三条件:安装 Microsoft 官方简体中文语言包、执行 Configure Display Language 命令并严格选 zh-cn、彻底重启进程;缺一不可,否则菜单栏等仍为英文。

VSCode 中文界面不是“装了就自动变”,必须同时满足三个硬性条件:装对官方语言包、执行 Configure Display Language 命令选 zh-cn、彻底重启进程。漏掉任一环节,顶部菜单栏、命令面板、设置导航栏就永远是英文。
只装 Microsoft 官方语言包,别碰任何第三方“汉化插件”
搜 chinese 会出来一堆名字带“中文”“汉化”“Pro”的插件,但真正起作用的只有一个:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 在扩展面板(
Ctrl+Shift+X)里粘贴全名搜索,认准蓝勾图标和 Microsoft 署名 - 装错第三方插件后,可能出现
Cannot read property 'translate' of undefined报错,或菜单部分乱码、命令面板消失 - 安装完右下角会弹
Restart Now提示——必须点它;点Reload Window不触发语言加载 - 如果扩展图标变灰(被禁用),需手动启用,否则后续步骤全无效
Configure Display Language 命令只认 zh-cn,其他写法全静默失败
语言包只是“备好了字典”,真正让 VSCode 拿起这本字典去翻译的,是 Configure Display Language 这条命令。它不接受任何变体,且不会报错提示你输错了。
- 按
Ctrl+Shift+P打开命令面板,输入完整命令名:Configure Display Language(不含“中文”“change”等词) - 从下拉列表中**严格选择
zh-cn** ——zh_CN、ZH-CN、zh、Chinese全无效,界面照旧英文 - 选完弹出提示时,必须点
Change and Restart或Restart;点OK或关掉弹窗,配置不会写入 - 如果命令面板里根本搜不到这个命令,基本说明语言包没装成功,或装完没重启过任何窗口
命令失效时,直接写 locale.json 是最稳兜底方式
当命令面板卡死、UI 无响应、或企业策略禁用插件安装时,手动编辑 locale.json 绕过所有中间层,强制指定语言。它的优先级高于 UI 设置,且不依赖插件状态。
- 先彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 在活动监视器结束Code Helper - 定位并编辑文件:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
- Windows:
- 文件内容严格为一行 JSON:
{"locale":"zh-cn"}(无 BOM、无多余空格、无逗号、UTF-8 编码) - 如果文件不存在,直接新建;如果已有
settings.json里写了"locale",建议删掉或注释掉,避免冲突
真正容易被忽略的是:终端、调试控制台、Git 输出、Python 插件弹窗这些地方显示英文,不是汉化失败——它们不走 VS Code 的 locale 配置,而是取决于系统语言或运行时环境。盯住顶部菜单栏(文件/编辑/视图)、命令面板占位符(“请输入命令或搜索设置”)、设置左侧导航(“用户”“工作区”)这三处,全中文才算真生效。











