pre-commit 如何禁用未暂存文件检查以支持部分改动提交？

机制说明 #

pre-commit 默认启用暂存隔离规则：钩子执行前会扫描工作区未暂存的改动，检测到内容时会将这部分改动临时缓存为补丁，仅让钩子校验暂存区的待提交文件，钩子运行完成后再恢复缓存的工作区改动，避免未暂存内容干扰钩子校验结果。你日志里出现的未暂存文件警告、stash/restore缓存补丁的提示，就是该规则触发的表现。

操作方案 #

• 单次提交临时关闭
  执行commit命令时追加--no-stash参数即可，本次提交完全跳过未暂存文件检测和自动stash流程：
  git commit --no-stash -m "提交内容说明"
  该模式下钩子直接读取当前暂存区的文件开展校验，完全支持你只提交部分改动的操作需求，不会对未暂存的工作区内容做任何改动。
• 全局永久关闭
  如果不想每次提交手动追加参数，可将配置写入git全局配置，之后所有项目的pre-commit都不再触发未暂存文件检测逻辑：
  git config --global pre-commit.no-stash true

常见认知澄清 #

你日志中所有钩子显示(no files to check)Skipped，和未暂存检测逻辑无关：从git输出可以确认，当前暂存区是空的——.gitignore是未暂存的修改、.pre-commit-config.yaml是未跟踪文件，没有任何内容被git add加入暂存区，因此钩子找不到需要校验的目标文件。正常将待提交内容加入暂存区后，钩子即可正常运行。

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