如何查找包含特定文件版本的所有Git提交标签

核心思路 #

要找到包含目标文件当前版本的所有标签，关键是先定位该文件最后一次发生变更的提交，之后所有在历史链上包含该提交的标签，都对应着文件未再修改的版本（也就是你要的当前版本）。

操作步骤 #

1. 定位文件最后一次变更的提交
   执行以下命令，获取目标文件最后一次被修改的提交哈希值：

   git log -1 --format="%H" -- <你的文件路径>
   

   示例（查找src/utils/helper.js的最后变更提交）：

   git log -1 --format="%H" -- src/utils/helper.js
   

   输出的一串哈希值（如a1b2c3d）就是该文件最后修改的提交ID。

2. 筛选包含该提交的所有标签
   用第一步得到的提交哈希，执行以下命令列出所有包含该提交的标签：

   git tag --contains <提交哈希>
   

   针对大型仓库，可使用更高效的git for-each-ref命令：

   git for-each-ref --format="%(refname:short)" refs/tags --contains <提交哈希>
   

补充说明 #

• 如果工作区有未提交的修改，上述命令会基于HEAD中的文件版本查找。若要针对工作区修改后的版本，需先提交或暂存修改。
• --contains参数会检查标签指向的提交是否能追溯到目标提交，只要标签所在分支历史包含该文件最后变更的提交，就会被列出，完全匹配“变更之后所有包含该版本的标签”的需求。

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