GitLens 界面中文显示完全依赖 VSCode 全局语言设置:需安装官方简体中文语言包、设 locale 为 zh-cn、彻底重启 VSCode;GitLens 自身无语言选项,其提示中文还受 Git 编码(core.quotepath、i18n.commitencoding)和终端 UTF-8 设置影响。

GitLens 本身没有独立中文语言包,它的界面文字是否显示中文,完全取决于 VSCode 的全局语言设置——装对语言包、选对 locale、重启到位,它就自然变中文;否则哪怕 GitLens 功能全开,提示也全是英文。
VSCode 必须先完成官方汉化
GitLens 的菜单、右键项、侧边栏标题、内联 blame 提示等,都走 VSCode 的 UI 语言通道。没汉化 VSCode 主体,GitLens 就不可能中文。
- 只装
Chinese (Simplified) Language Pack for Visual Studio Code(作者 Microsoft,带蓝勾) - 按
Ctrl+Shift+P输入Configure Display Language,选zh-cn(不是zh、zh-CN或Chinese) - 必须彻底重启 VSCode:关掉所有窗口,任务管理器确认
Code.exe进程已退出,再重开 - 验证点:顶部菜单栏(文件/编辑/视图)、命令面板占位符、设置界面左侧导航栏是否为中文——这三处中文了,GitLens 才可能中文
GitLens 提示信息仍为英文?检查终端和提交编码
GitLens 在编辑器内显示的 blame 行提示(如“修改于 2024-05-12,作者张三”)会中文,但部分弹窗或 hover 提示若含 Git 命令输出(比如 git log --oneline 结果),就依赖 Git 自身的输出语言和编码。
当用户提及 GitHub URL,或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时,请使用此技能。触发条件包括以下短语:“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”,或消息中包含任何 github.com URL。
-
git config --global i18n.LANG zh-Hans已废弃,Windows 上多数 Git 版本忽略它,甚至引发git status乱码 - 真正有效的是:
git config --global core.quotepath false(避免中文路径被转义成\344\270\200) - 提交信息编码设为 UTF-8:
git config --global i18n.commitencoding utf-8,否则git log中中文 commit message 显示为问号 - 确保 VSCode 终端用的是 Git Bash,并已设为 UTF-8:右键 Git Bash 图标 → Properties → Options → Active code page → 改为
65001
GitLens 设置里没有语言选项,别瞎找
打开 Settings 搜索 gitlens,所有配置项都是功能开关(如 gitlens.hovers.currentLine.enabled)、快捷键或行为控制,**没有 language、locale、i18n 相关字段**。
- 这不是遗漏,是设计如此:GitLens 不提供多语言切换开关
- 如果界面某处仍是英文(比如某个 tooltip 或按钮文字),大概率是 VSCode 未完全加载语言资源,或插件版本过旧(升级到最新版 GitLens ≥ 14.x)
- 极少数情况下,某些动态生成的提示(如 compare branch 弹窗里的分支名)会保留 Git 命令原始输出,这时需检查 Git 的
core.quotepath和终端编码
最容易被忽略的其实是「重启不彻底」和「locale 写错大小写」——zh-cn 小写在新版 VSCode 中可能失效,而 zh-CN 大写在旧版中又不认。直接看 settings.json 里生成的 locale.json 文件内容最准,别信界面上的“已应用”。










