gitlens 的 review 功能需手动启用：执行 gitlens: toggle review mode，且仅对已提交、分支关联上游（git branch -vv 显示 [origin/main]）的文件生效；默认不生效因未开启审查模式、分支无追踪关系或文件未提交。
GitLens 的 Review 功能怎么开，为什么默认不生效
VSCode 自带的 Git 面板不提供代码审查（Review）能力，必须依赖 GitLens 插件。但装完插件后，右键文件看不到 “Start Review” 选项——常见原因是没启用审查模式或当前分支未关联远程追踪分支。
实操建议：
- 确保已安装
GitLens（不是 Git Graph 或其他 Git 插件） - 打开命令面板（
Ctrl+Shift+P），执行GitLens: Toggle Review Mode启用审查模式 - 检查当前分支是否设置了上游（upstream）：在终端运行
git branch -vv，若显示[origin/main]才算关联成功；否则先执行git branch --set-upstream-to=origin/main main - 审查只对已提交到本地仓库的文件生效，未暂存（
U状态）或未提交的修改不会出现在 Review 视图中
审查时文件显示为粗体，但点不开差异对比
粗体表示“待审查”，但点击后无法查看 diff，通常是因为 GitLens 没能定位到上一次提交的基准版本，或者当前文件被重命名/移动过，导致历史链断裂。
实操建议：
- 确认文件已提交过至少一次（
M或A状态且已commit），纯新增未提交的U文件不参与审查 - 避免在审查过程中对文件做重命名、剪切粘贴等操作；如已发生，手动右键该文件 →
GitLens: View File History，看能否加载出历史记录 - 若历史为空，可临时切换到上一个提交（
Git: Checkout Revision...），再切回来，强制刷新 GitLens 缓存 - 审查窗口默认不自动打开 diff，需双击待审查文件，或右键选择
GitLens: Compare With Previous Revision
审查状态 90 天后自动关闭，怎么改或禁用
GitLens 默认将闲置超过 90 天的审查标记为 “stale” 并隐藏，这个行为不可关闭，但可以调整周期或手动重置。
实操建议：
- 修改有效期：在 VSCode 设置中搜索
gitlens.review.staleDays，改为需要的天数（例如180） - 手动重置状态：右键已标记为 stale 的文件 →
GitLens: Mark as Reviewed或Mark as Unreviewed - 注意：该设置是全局生效，不按项目区分；如果团队协作，建议统一配置并提交到
.vscode/settings.json中 - 没有“永久开启”选项，GitLens 设计上就假设审查是有时效性的协作行为
多人协作时 Review 状态不同步，别人看不到我的标记
GitLens 的 Review 状态完全本地存储（保存在 ~/.gitlens/reviews/ 或工作区 .gitlens 目录下），不走 Git 提交，也不上传远程仓库。所以 A 标记了“已审查”，B 拉取代码后依然看到“待审查”。
实操建议：
- 不要依赖 GitLens Review 状态做流程卡点；它本质是个人辅助工具，不是协作协议
- 真正需要同步的审查结论，应通过 Pull Request（GitHub/GitLab）完成，那里有评论、批准、状态检查等完整机制
- 如坚持本地协同，可导出审查报告：
GitLens: Export Reviews生成 JSON，手动共享给同事（但无法自动同步状态） - 插件本身不支持审查状态共享，这是明确的设计限制，不是配置问题
