Windows系统下Git的core.hooksPath配置失效问题求助

我之前在Windows上也踩过这个一模一样的坑！你描述的情况太典型了——默认钩子目录能正常工作，一设全局hooksPath就失效，核心问题其实是Git在Windows环境下的路径解析逻辑，再加上几个容易忽略的小细节，咱们一步步来排查解决：

一、先把路径格式搞对 #

Git在Windows下对路径的识别有特殊要求，别乱用单反斜杠，试试这几种写法：

• 用正斜杠（最稳妥）：

  git config --global core.hooksPath "C:/Code/.githooks"
  

• 用双反斜杠（因为Windows的反斜杠在Git配置里需要转义）：

  git config --global core.hooksPath "C:\\Code\\.githooks"
  

• 如果用用户目录相对路径，确保~指向正确的用户文件夹（比如C:\Users\你的用户名），命令写成：

  git config --global core.hooksPath "~/.githooks"
  

二、检查钩子文件的权限和命名 #

虽然你用.NET写的钩子本身没问题，但Git在Windows下有两个关键点要注意：

1. 可执行权限：不管是脚本还是调用exe的批处理，都要给文件加执行权限。可以右键钩子文件→属性→安全，确保当前用户有「读取和执行」权限；或者用Git Bash运行：

   chmod +x C:/Code/.githooks/*
   

2. 文件名不要加后缀：Git钩子的文件名必须严格匹配（比如pre-commit、pre-push），不能加.exe或.bat后缀。如果你的.NET程序是编译好的exe，写个简单的批处理脚本当钩子入口就行，比如创建一个叫pre-commit的文件：

   @echo off
   C:\Code\YourHookProject\bin\Release\PreCommitHook.exe
   exit %errorlevel%
   

三、验证配置和触发逻辑 #

1. 先确认全局配置是否生效：

   git config --global --get core.hooksPath
   

   输出的路径必须和你实际的钩子目录完全一致，多一个少一个斜杠都不行。
2. 用调试模式看钩子是否被调用：

   git commit -m "test hook" --verbose
   

   观察输出日志，如果有钩子相关的报错或提示，就能直接定位问题。

四、排除局部配置冲突 #

有些仓库可能单独设置了局部hooksPath，会覆盖全局配置。进入你的仓库目录，运行：

git config --local --get core.hooksPath

如果有输出，说明局部配置优先级更高，用下面的命令删掉它即可：

git config --local --unset core.hooksPath

你说得对，默认目录下能正常工作就说明.NET钩子本身没问题，就是配置和路径的小细节没处理对。我之前就是因为用了单反斜杠导致路径解析失败，改成正斜杠就立刻生效了，你可以试试上面的方法！

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