终端UI无法被VSCode语言包汉化,因其是独立子进程,由Chromium和系统底层渲染;仅shell环境变量(如LANG)可影响命令输出中文。

终端(Terminal)显示英文不是汉化失败,而是设计如此——它不读 VSCode 的 locale 配置,改任何 settings.json 或 locale.json 都无效。
为什么 Terminal 无法被 VSCode 语言包汉化
集成终端是 Electron 启动的独立子进程,运行在系统 shell 环境中(如 PowerShell、zsh、bash),它的界面文字(如 Terminal 1 标签、右上角关闭按钮提示、新建终端菜单项)由 Chromium 和操作系统底层提供,VSCode 的语言包完全不参与渲染。
常见误判现象包括:
- 顶部菜单栏、设置页、命令面板全是中文,但按
Ctrl+`打开的终端标签仍显示Terminal 1 - 右键点击终端标签页,选项仍是
Split Terminal、Close Terminal - 终端内执行
code --version输出仍是英文,这不是终端问题,而是 CLI 工具自身语言未切换
哪些 Terminal 相关内容能“间接”变中文
虽然终端 UI 本身不可汉化,但以下部分可受系统或 shell 层级影响:
-
LANG或LC_ALL环境变量设为zh_CN.UTF-8(Linux/macOS)后,部分命令输出(如ls --help、git status)可能显示中文提示(取决于命令是否内置 i18n 支持) - Windows 用户若系统区域设为「中文(简体,中国)」,PowerShell 的部分内置错误信息(如
Get-ChildItem : 找不到路径)会自动本地化 - VSCode 的
Terminal: New Terminal命令名称在命令面板里是中文(因属 VSCode 主进程 UI),但执行后新开的窗口标题仍是英文
别踩这些“伪解决方案”坑
大量教程推荐的所谓“终端汉化法”,在 VSCode 2026 年版中已全部失效或起反作用:
- 在
settings.json里加"terminal.integrated.locale": "zh-cn"→ 该配置项自 1.115 版起已被移除,VSCode 会静默忽略 - 手动修改
~/.vscode-server/data/Machine/xxx/locale.json(Remote-SSH 场景)→ 对终端进程无影响,只控制远程端的主 UI - 安装第三方“终端汉化插件” → 多数为旧版残留,可能覆盖
package.json导致扩展加载失败,或注入非法 CSS 引发渲染异常 - 用
code --locale=zh-cn启动 → 只影响主窗口,对后续 fork 出的终端子进程无效
真正值得做的三件事
接受终端 UI 英文的事实,把精力放在实际影响开发效率的地方:
- 检查你的 shell 初始化文件(
~/.zshrc、~/.bashrc或$PROFILE)是否设置了export LANG=zh_CN.UTF-8,这能让man、git等工具输出中文帮助(需对应 locale 已安装) - 在 Remote-SSH 场景下,确保远程 Linux 机器已启用中文 locale:
sudo locale-gen zh_CN.UTF-8 && sudo update-locale - 如果某插件(如 GitLens)在终端里输出的路径或提示仍是英文,那是插件自身未适配,需查看其文档是否支持
gitlens.language等独立语言配置项
最常被忽略的一点:终端里执行的命令(比如 npm run dev)输出是否中文,和 VSCode 无关,只取决于 Node.js 进程启动时的环境变量与依赖库的 i18n 实现。别在 VSCode 设置里找答案。


















