Git钩子在Linux与Windows间表现不一致的原因咨询

这是个典型的跨平台Git钩子适配问题，我来帮你拆解背后的原因：

1. 原脚本在Linux（树莓派）上失效的核心问题 #

• 路径格式不兼容：原脚本里用了Windows风格的C:/GIT/...路径，Linux系统完全无法识别这种格式——这是最基础的跨平台错误，哪怕你后来修改了路径，还有更深层的问题。
• Git钩子的环境变量干扰：Git在触发post-receive钩子时，会自动设置一系列本地环境变量（比如GIT_DIR、GIT_WORK_TREE），这些变量会直接覆盖你脚本里手动定义的同名变量。这就导致你执行git --work-tree=$TARGET --git-dir=$GIT_DIR checkout时，Git被环境变量误导，找不到正确的仓库位置，所以会出现类似“master is not a git repository”的错误。你之前尝试取消环境变量但没生效，大概率是取消的时机不对，或者没有完全清除所有冲突的变量。
• checkout -f的潜在风险：在裸仓库的钩子中直接强制checkout到工作树，如果工作树存在未提交的本地修改、或者Git状态异常，很容易触发执行异常，甚至可能导致钩子陷入循环（比如错误的操作又触发了新的Git事件）。

2. 新脚本能正常工作的关键原因 #

• 路径适配Linux标准：换成了Linux原生的/home/pi/...路径，系统可以正确解析。
• 彻底清除Git环境变量：unset $(git rev-parse --local-env-vars)这行命令会一次性清除所有Git钩子自带的环境变量，让后续的Git命令完全使用你指定的仓库路径，不会被系统预设的变量干扰。
• 改用git pull更适合部署场景：git pull本质是git fetch + git merge，在已经克隆好的工作树中执行，逻辑更简单稳定——它会自动拉取远程裸仓库的最新代码，避免了checkout命令可能带来的工作树状态冲突问题，尤其适合持续部署的场景。

3. 关于分支名从master改为origin的疑问 #

这里其实是个小误解：你新脚本里定义的BRANCH="origin"并没有实际被用到，真正生效的是你的工作树本地分支关联的远程分支。比如你的工作树本地master分支默认关联的是远程仓库（origin）的master分支，所以git pull会自动拉取origin的master分支到本地。你可能混淆了远程仓库名（默认是origin）和分支名（master），所以这个修改其实是“误打误撞”的调整，真正让脚本工作的不是分支名的变化，而是命令从checkout换成了pull，以及环境变量的清除。

跨平台Git钩子的避坑指南 #

• 路径格式严格区分：Windows用C:/xxx或C:\xxx，Linux用/home/xxx，绝对不能混用。
• 钩子开头先清环境变量：在Linux的Git钩子中，务必先执行unset $(git rev-parse --local-env-vars)，避免Git自带的变量干扰自定义操作。
• 优先选择稳定的部署命令：对于已克隆的工作树，git pull比直接checkout更可靠，如果工作树有需要保留的本地配置，还可以配合git stash临时保存修改后再拉取。

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