VSCode中文语言包安装后界面仍英文,需确认三件事:已安装Microsoft官方语言包、通过Configure Display Language命令设locale为"zh-cn"、彻底重启进程;三者缺一不可。

中文语言包安装后界面仍英文?先查这三件事
VS Code 不会因为装了中文语言包就自动切语言,必须同时满足「已安装官方包」「locale 值设为 zh-cn」「彻底重启」——缺一不可。常见现象是菜单栏、设置页还是英文,但命令面板里能搜到中文提示,说明语言包已加载但未激活。
- 打开命令面板(
Ctrl+Shift+P),输入Configure Display Language,确认列表中是否出现zh-cn选项;没出现说明语言包没装对或版本太低 - 检查已安装扩展:在扩展面板(
Ctrl+Shift+X)搜索ms-ceintl.vscode-language-pack-zh-hans,确保状态是“启用”而非灰色禁用 - 查看当前生效的 locale 配置:按
Ctrl+Shift+P→Open User Settings (JSON),确认settings.json里没有"locale": "zh-cn"这行(1.70+ 版本已弃用该写法,写了也无效)
怎么确认 locale.json 是否正确生成并被读取?
locale.json 是 VS Code 1.70+ 唯一认可的语言配置文件,它不由用户手动创建,而是由 Configure Display Language 命令自动生成。路径和内容必须严格匹配,否则不生效。
- Windows 路径:
%APPDATA%\Code\User\locale.json;macOS:~/Library/Application Support/Code/User/locale.json;Linux:~/.config/Code/User/locale.json - 文件内容只能是:
{"locale":"zh-cn"}(注意:小写、连字符、无空格、UTF-8 无 BOM) - 如果文件存在但仍是英文,大概率是后台进程没清干净——关掉所有窗口后,Windows 查任务管理器杀掉所有
Code.exe,macOS 用活动监视器结束Electron进程,再重新启动
为什么部分界面(如终端、调试控制台)还是英文?
VS Code 的终端(Integrated Terminal)和调试控制台(Debug Console)使用的是系统 shell 和运行时环境的语言设置,不走编辑器自身的 locale.json 流程。它们显示什么语言,取决于你系统环境变量(如 LANG、LC_ALL)和所用 shell 的配置。
- 终端内执行
echo $LANG(macOS/Linux)或echo %LANG%(Windows CMD),看输出是否含zh_CN或zh - VS Code 终端默认继承系统语言,但不会主动翻译 shell 命令、错误提示或 Python/Node.js 等运行时输出
- 想让 Node.js 错误信息变中文?得改 Node.js 自身的 locale(如启动时加
--icu-data-dir),和 VS Code 无关
汉化进度不是百分比,而是分层生效
官方中文语言包覆盖范围有明确分层:主菜单、命令面板、设置页、状态栏、内置扩展 UI(如 Git、Notebook)基本全量汉化;但第三方插件、调试器 UI、终端输出、语言服务提示(如 TypeScript 错误文本)通常保持英文——这不是“没汉化完”,而是设计如此。
比如 Python 插件的右键菜单可能是中文,但其 LSP 返回的错误信息仍为英文,因为那是 Python 官方解释器本身输出的;同理,Go 插件的文档悬浮提示来自 godoc,也不受 VS Code 语言包控制。强行用第三方“补全汉化”插件,反而容易引发乱码或 UI 错位。


















