Git pre-push钩子在Visual Studio Git界面中无法正常工作

问题分析 #

你编写的pre-push钩子在终端执行git push时正常工作，但通过Visual Studio的Git界面推送时报错，且输出窗口无有效错误信息，核心原因大概率是VS执行钩子时的运行环境、工作目录或环境变量与终端不一致，导致脚本中某些命令无法正常执行。

具体解决步骤 #

1. 修正脚本的shebang路径 #

Windows环境下，VS使用的Git Bash或内置bash环境路径可能和终端不同，将脚本开头的#!/bin/bash替换为更通用的写法，让系统自动查找可用的bash环境：

#!/usr/bin/env bash

2. 添加调试日志捕获错误 #

在脚本开头加入日志配置，把所有执行日志（包括错误）写入文件，方便排查具体问题：

#!/usr/bin/env bash

# 开启调试日志，输出到用户目录下的pre-push-debug.log
LOG_FILE="$HOME/pre-push-debug.log"
exec > "$LOG_FILE" 2>&1
set -x # 开启命令执行追踪，每一步命令都会记录到日志

# 原脚本内容...
branch=$(git rev-parse --abbrev-ref HEAD)
remote=$(git config --get branch.$branch.remote)
remote_branch=$(git config --get branch.$branch.merge | sed 's#^refs/heads/##')

# 先fetch远程分支，确保本地有最新引用
git fetch "$remote"

if git diff --name-only "$remote/$remote_branch" HEAD | grep -q "NDI"; then
  # 使用dotnet的绝对路径，避免环境变量找不到命令
  # Windows下示例路径，根据实际安装路径调整
  # "C:/Program Files/dotnet/dotnet.exe" test
  dotnet test
fi

if [ $? -ne 0 ]
then
  echo "Tests failed. Push cancelled."
  exit 1
fi

执行VS推送后，查看$HOME/pre-push-debug.log文件，就能看到脚本执行时的具体错误。

3. 确保远程分支引用存在 #

VS可能不会自动同步远程分支，在脚本中添加git fetch "$remote"命令，确保本地能找到$remote/$remote_branch的引用，避免git diff命令报错。

4. 指定dotnet命令的绝对路径 #

如果VS的环境变量中没有包含dotnet的安装路径，脚本会找不到dotnet命令。可以用终端执行which dotnet（Git Bash环境）或where dotnet（CMD环境）获取绝对路径，替换脚本中的dotnet：

# Windows下示例，根据实际路径调整
"C:/Program Files/dotnet/dotnet.exe" test

5. 检查钩子脚本权限 #

确保pre-push脚本有可执行权限，在终端执行：

chmod +x .git/hooks/pre-push

（Windows下该步骤可忽略，Linux/macOS环境必须执行）

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