Git仓库中查找特定文件版本及关联版本的技术方案咨询

针对你需要跟踪docker-compose.yml(A)和docker-compose.override.yml(B)的版本关联，同时避免手动操作出错的需求，我整理了几个从易到难、逐步自动化的可行方案，兼顾易用性和准确性：

一、基础规范化：结构化提交信息+Git钩子防错 #

如果不想立刻写复杂脚本，先从规范提交信息入手，同时用Git钩子强制格式，避免用户输入错误：

1. 定义固定提交信息格式 #

要求所有提交必须包含A和B的当前版本，比如统一格式：

Update [A/B] to <version> | Current A: <a_version>, B: <b_version>

示例：

• 更新A到v1.1，B保持v1.0：Update A to v1.1 | Current A: v1.1, B: v1.0
• 更新B到v1.1，A是v1.1：Update B to v1.1 | Current A: v1.1, B: v1.1

2. 用Git钩子强制验证格式 #

在仓库的.git/hooks目录下创建commit-msg脚本（赋予执行权限chmod +x commit-msg），内容示例（shell脚本）：

#!/bin/bash

COMMIT_MSG=$(cat "$1")

# 检查提交信息是否包含指定格式
if ! echo "$COMMIT_MSG" | grep -q "Current A: v[0-9]\+\.[0-9]\+, B: v[0-9]\+\.[0-9]\+"; then
    echo "错误：提交信息必须包含格式 'Current A: <version>, B: <version>'"
    echo "示例：Update A to v1.1 | Current A: v1.1, B: v1.0"
    exit 1
fi

这样用户提交时如果格式不符合，Git会直接拒绝提交，从源头避免错误。

3. 快速查询版本 #

• 找A的特定版本：用git log --grep="Current A: v1.1"，就能列出所有A处于v1.1的提交
• 找该A版本对应的所有B版本：在上述结果中，提取每个提交里的B: <version>部分即可，比如用：

  git log --grep="Current A: v1.1" --pretty=format:"%s" | awk -F'B: ' '{print $2}'
  

二、进阶自动化：版本提交脚本 #

写一个简单的脚本（shell或Python），让用户只需要输入更新的版本号，脚本自动完成提交、打标签的全部流程，彻底避免手动错误：

示例Shell脚本（update-version.sh） #

#!/bin/bash

# 提示用户选择更新的文件
read -p "更新A还是B？(A/B): " FILE
read -p "输入新版本号（如v1.1）: " NEW_VERSION

# 获取当前A和B的版本（这里假设你能从文件内容中提取版本，比如文件里有version字段）
# 如果你无法从文件提取，可以让用户输入当前版本，或者从最近的提交信息中解析
CURRENT_A=$(git log --grep="Current A:" --pretty=format:"%s" | head -1 | awk -F'A: ' '{print $2}' | awk -F', ' '{print $1}')
CURRENT_B=$(git log --grep="Current B:" --pretty=format:"%s" | head -1 | awk -F'B: ' '{print $2}')

# 检查文件是否修改
if git status --porcelain | grep -q "docker-compose.*.yml"; then
    # 生成提交信息
    COMMIT_MSG="Update $FILE to $NEW_VERSION | Current A: ${FILE == "A" ? $NEW_VERSION : $CURRENT_A}, B: ${FILE == "B" ? $NEW_VERSION : $CURRENT_B}"
    
    # 提交
    git add docker-compose.yml docker-compose.override.yml
    git commit -m "$COMMIT_MSG"
    
    # 自动打标签，格式为A-<a_version>_B-<b_version>
    TAG_NAME="A-${FILE == "A" ? $NEW_VERSION : $CURRENT_A}_B-${FILE == "B" ? $NEW_VERSION : $CURRENT_B}"
    git tag -a "$TAG_NAME" -m "$COMMIT_MSG"
    
    echo "提交成功！标签已创建：$TAG_NAME"
else
    echo "错误：文件未修改，请先更新文件内容再运行脚本！"
    exit 1
fi

用户只需要运行./update-version.sh，按提示输入A/B和新版本号，脚本就会自动完成所有操作，完全不用手动写提交信息或打标签。

查询优化 #

用标签查询会更高效：

• 找A的v1.1版本：git tag --list "A-v1.1_*"，直接列出所有A为v1.1时的B版本标签
• 查看某个标签对应的文件内容：git show A-v1.1_B-v1.0:docker-compose.yml

三、高级：版本映射文件+自动化维护 #

如果需要更清晰的版本关联记录，可以维护一个version-mapping.yml文件，每次提交时由脚本自动更新，记录每个提交的哈希、A版本、B版本：

示例version-mapping.yml：

version_history:
  - commit_hash: abc1234
    a_version: v1.0
    b_version: v1.0
  - commit_hash: def5678
    a_version: v1.1
    b_version: v1.0
  - commit_hash: ghi9012
    a_version: v1.1
    b_version: v1.1

脚本提交时自动追加新的记录到这个文件，然后一起提交。之后要查询时，直接用grep或YAML解析工具就能快速找到对应关系，比如：

# 找所有A为v1.1的记录
grep -A2 "a_version: v1.1" version-mapping.yml

总结 #

• 新手入门：先搞结构化提交信息+Git钩子，成本最低，能快速避免错误
• 追求效率：用自动化提交脚本，彻底解放手动操作
• 需要清晰记录：加版本映射文件，让版本关联一目了然

所有方案都不需要复杂的Git分支策略，完全基于提交信息、标签和简单脚本就能满足你的需求：找到A的特定版本，以及对应A版本的所有B版本。

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