Gerrit WebUI修改不显示及评审时修改无高亮问题咨询

我来帮你逐个排查这两个Gerrit的常见问题，都是和代码变更展示相关的，大概率是推送方式、缓存或者小配置的问题，咱们一步步来：

一、代码修改在Gerrit WebUI中无法正常显示 #

• 确认推送命令是否符合Gerrit规范：Gerrit要求必须推送至refs/for/<分支名>的引用路径，比如git push origin HEAD:refs/for/main。如果直接推送到普通分支（比如git push origin main），Gerrit不会生成对应的变更集，自然在WebUI里找不到。
• 检查推送是否成功落地：本地用git log确认提交已存在，然后去Gerrit的「我的变更」列表里查找。如果找不到，可能是权限不足（比如没有该分支的提交权限）或者服务器临时波动，尝试重新推送一次。
• 强制刷新浏览器缓存：有时候WebUI的静态资源缓存会卡住新变更的显示，按Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）强制刷新页面，再重新查看。

二、评审人员看不到修改高亮，显示无变更痕迹 #

这个问题通常是补丁集生成异常或者文件兼容性导致的：

• 本地先确认变更是否存在：在本地执行git diff <目标分支>..HEAD，比如git diff main..HEAD，看看是否真的有代码修改。如果本地diff都没有内容，那Gerrit肯定显示不了变更。
• 重新生成并推送补丁集：有时候Gerrit的补丁集同步会出问题，可以先执行git reset --soft HEAD^撤销当前提交，重新提交后再推送；或者用git push origin HEAD:refs/for/main --force强制更新补丁集（注意：仅限修改自己的变更集，不要覆盖他人的内容）。
• 检查文件类型与编码：Gerrit对二进制文件、超大文件或非UTF-8编码的文本文件可能不会提供高亮展示。确认你修改的是常规文本文件，编码为UTF-8这类Gerrit支持的格式。
• 让评审人员清除缓存：评审的浏览器可能缓存了旧的文件内容，让他们也执行强制刷新操作后再查看变更。
• 排查服务器端问题：如果多人都遇到这个情况，可能是Gerrit服务器的补丁集解析出现异常，联系管理员查看gerrit.log日志，找有没有类似「patch set parsing failed」的错误信息。

内容的提问来源于stack exchange，提问作者Fiona