必须手动关闭全局codelens并启用语言作用域控制，仅对typescript/javascript文件的function、class、export符号显示git信息；同时确保文件已被git跟踪、gitlens.decorations.enabled为true，且user.email与平台账户完全一致。
GitLens 的配置不是“开箱即用”就完事的——默认设置下，CodeLens 信息泛滥、blame 注释干扰阅读、关键作者信息反而被埋没。必须手动调整几处核心配置，才能让 GitLens 真正服务于你的协作节奏和代码审查习惯。
如何关闭无意义的 CodeLens 并只保留关键函数/类级历史
默认开启 gitlens.codeLens.enabled 后，每个 if 块、每行 console.log 都可能显示提交信息，视觉噪音极大，且多数无业务价值。
真正需要追溯的，是函数定义、类声明、导出语句这类有明确语义边界的符号。你应该：
- 在
settings.json中显式关闭全局 CodeLens："gitlens.codeLens.enabled": false - 启用语言作用域控制，只为 TypeScript/JavaScript 文件开启函数与类级别追踪：
{ "gitlens.codeLens.scopes": ["function", "class", "export"], "gitlens.codeLens.languages": ["typescript", "javascript"] } - 避免误配
symbolScopes：它不接受通配符或正则，只认精确字符串如"FunctionDeclaration"（AST 类型名），填错会导致整个作用域失效
为什么 gitlens.currentLine.enabled 开启后仍看不到行尾作者注释
常见现象是配置写了、重启 VS Code 了，但代码行右侧始终空白。这不是插件没生效，而是触发条件未满足：
- 文件必须已被 Git 跟踪（
git status能列出该文件），新建未git add的文件不会显示 - 当前工作区根目录下必须存在有效的
.git目录；多根工作区中，仅激活的根目录才参与 blame 计算 - 确保未禁用装饰器：
"gitlens.decorations.enabled": true是前提，否则即使currentLine开启也无视觉反馈 - Windows 用户注意路径大小写：若 Git 仓库用小写路径初始化，而 VS Code 打开的是大写路径（如
C:\MyProjvsc:\myproj），blame 会静默失败
gitlens.gutterIcons.enabled 和 gitlens.currentLine.enabled 的实际分工
这两个开关常被混用，但它们控制的是完全不同的 UI 区域和交互逻辑：
-
gitlens.gutterIcons.enabled控制编辑器最左侧“行号栏”里的小图标（如提交哈希前缀、分支标记），点击可快速跳转到对应 commit -
gitlens.currentLine.enabled控制代码行**右侧空白区**（gutter 右侧）的内联文本注释，内容含作者名、相对时间、简短提交信息 - 二者可独立开关：例如关闭右侧注释（减少干扰），但保留左侧图标（保留快速跳转能力）
- 性能敏感项目建议关掉
currentLine，因为它的实时 blame 计算会轻微拖慢大文件滚动；而 gutter 图标是预加载缓存的，几乎无开销
多人协作中作者头像不显示或显示错误邮箱的根源
悬停时头像空白、或显示成 GitLab 默认机器人头像，通常不是 GitLens 问题，而是 Git 提交元数据与平台账户未对齐：
- 检查本地 Git 配置：
git config --global user.email输出的邮箱，必须与你在 GitHub/GitLab/Gitee 账户绑定的主邮箱**完全一致**（包括大小写） - 如果用了公司统一 SSO 邮箱（如
name@corp.com），但提交时误配成个人 Gmail，头像就无法关联 - VS Code 内置终端执行
git log -1 --pretty="%an %ae"，确认最近一次提交的 author email 是否正确；若错误，需用git commit --amend --author="Name <correct>"</correct>修正 - GitLens 不缓存头像，每次悬停都实时调用平台 API，网络策略或代理拦截也可能导致头像加载失败（此时 hover 文本仍正常）
真正难调的不是参数本身，而是 GitLens 的行为高度依赖底层 Git 状态的准确性——一个错配的 user.email、一个未 add 的文件、一个多根工作区路径偏差，都会让某项功能“看起来没反应”。配置前先用 git status 和 git log -1 确认基础状态，比反复改 setting 更省时间。
