Git status无法显示fixup提交待变更文件问题咨询

为什么会检查到无关文件 #

你遇到的无关文件扫描问题，核心原因是pre-commit钩子的写法存在缺陷，和fixup提交本身的逻辑无关：

• 你通过git status -s | cut -c4-解析待提交文件的方式不可靠：git status的短格式输出会同时展示暂存区、工作区的文件状态，遇到重命名文件、带空格/特殊字符的文件时，cut -c4-会解析出错误的路径；在pre-commit钩子的执行环境中，Git会临时设置GIT_INDEX_FILE指向本次提交的临时索引，git status的输出也会受此影响，无法准确匹配你预期的文件列表。
• 最关键的问题：当上述管道命令解析出的文件列表为空时，你的命令会直接执行flake8 --config=flake8，没有传入任何待检查文件路径，此时flake8会默认递归扫描当前工作目录下所有Python文件，这就是你看到大量不在预期内的文件被检查的直接原因。

另外需要明确：git commit --fixup=<commit> 不会自动筛选提交内容，它只会自动生成fixup! <目标提交信息>格式的提交说明，方便后续执行git rebase -i --autosquash时自动合并到目标提交，本次提交实际包含的内容完全由你执行commit时暂存区的内容决定，和目标提交f673953437包含的文件没有自动绑定关系。

查看fixup提交实际包含内容的方法 #

不管是普通提交还是fixup提交，查看待提交内容的正确命令都不依赖git status：

• 查看本次提交包含的文件列表：执行git diff --cached --name-only，输出的所有路径就是会被包含在本次提交中的文件。
• 查看本次提交的完整代码变更：执行git diff --cached，可以看到所有待提交的代码差异。
• 如果已经完成fixup提交，想查看该提交的内容，直接执行git show <fixup提交的哈希值>即可。

修复pre-commit钩子的正确写法 #

替换你原来的钩子代码为以下内容，可以避免无关文件扫描，同时兼容特殊文件名、删除文件等场景：

#!/bin/bash
# 读取本次提交中所有新增/修改/重命名/复制的Python文件，用null分隔兼容特殊文件名
mapfile -d '' py_files < <(git diff --cached --name-only -z --diff-filter=ACMRT | grep -zE '\.py$')

# 没有待检查的Python文件时直接退出，避免flake8全量扫描
if [ ${#py_files[@]} -eq 0 ]; then
    exit 0
fi

# 仅检查本次提交涉及的Python文件
flake8 --config=flake8 "${py_files[@]}"

命令参数说明：

• --cached：仅读取暂存区（即本次提交要包含的内容）的变更，不受工作区未暂存修改影响
• -z：使用null字符分隔文件名，彻底解决带空格、换行、特殊字符的文件名解析错误问题
• --diff-filter=ACMRT：仅筛选新增、复制、修改、重命名、文件类型变更的文件，排除已删除的文件避免flake8报文件不存在的错误

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