Windows下Git Bash的PHP别名在Git提交流程中无法正常工作

问题场景 #

在Windows上使用Laravel Herd时，Git Bash中配置的php等别名直接执行正常（比如php -v能返回正确版本），但运行Git pre-commit钩子时，却提示php: command not found。已在.bashrc和.bash_profile中添加PATH及别名配置，但钩子流程里完全不生效。

核心原因 #

• Git执行钩子时，启动的是非交互式、非登录的Bash环境，不会自动加载.bashrc或.bash_profile中的配置。
• Bash别名仅在交互式shell中生效，脚本（包括Git钩子）无法直接调用别名。

解决方案 #

方案1：钩子中直接使用PHP绝对路径 #

在pre-commit钩子里，把php命令替换成Herd的php.bat完整路径：

# 替换pre-commit里的php调用为绝对路径
/c/Users/MyUser/.config/herd/bin/php.bat your-test-script.php

方案2：让钩子强制加载bash配置文件 #

在pre-commit钩子的最开头添加一行，强制加载你的.bashrc配置：

source ~/.bashrc

注意：如果你的.bashrc里有针对交互式shell的判断（比如[[ $- == *i* ]] && ...），需要注释掉或调整，确保非交互式shell也能加载配置。

方案3：用函数替代别名（最可靠） #

把.bashrc和.bash_profile中的别名改成Bash函数，函数在非交互式shell中也能生效：

export PATH=$PATH:"/c/Users/MyUser/.config/herd/bin/"

# 用函数替代原别名
php() {
    php.bat "$@"
}
herd() {
    herd.bat "$@"
}
laravel() {
    laravel.bat "$@"
}
composer() {
    composer.bat "$@"
}

修改后重启Git Bash，钩子就能正常识别php命令了。

方案4：配置Git使用登录shell执行钩子 #

设置Git全局配置，让它用登录shell运行钩子，这样会自动加载.bash_profile：

git config --global core.shell "bash -l"

该设置会影响所有Git仓库的钩子环境，测试无误后再长期使用。

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