Git代码推送前使用SonarQube做代码质量校验是否可行，如何实现？

该需求技术层面完全可实现，核心依赖Git的钩子机制配合SonarQube的质量门禁能力，既可以做本地客户端层面的推送拦截，也可以搭配Git服务端、CI系统做服务端层面的强制卡点，完全满足「先扫描校验、后推送代码」的要求。

• 前置准备
  1. 完成SonarQube服务端部署，为目标项目创建专属项目密钥、扫描令牌
  2. 所有开发者本地安装SonarScanner扫描客户端，提前配置好SonarQube服务地址、扫描令牌等全局环境变量，避免重复输入敏感信息
• 配置Git pre-push钩子
  1. 进入本地项目仓库的.git/hooks目录，将目录下的pre-push.sample模板文件重命名为pre-push（无文件后缀）
  2. 给pre-push文件添加可执行权限：Linux/macOS环境执行chmod +x pre-push，Windows环境可直接通过文件属性配置执行权限
  3. 将以下逻辑写入pre-push文件：

  #!/bin/bash
  echo "正在执行SonarQube代码质量扫描，请稍候..."
  # 执行SonarQube扫描，替换参数为项目实际配置
  sonar-scanner \
    -Dsonar.projectKey=你的项目唯一标识 \
    -Dsonar.host.url=你的SonarQube服务访问地址 \
    -Dsonar.login=你的项目扫描令牌 \
    -Dsonar.qualitygate.wait=true # 等待质量门禁校验结果返回再结束进程
  
  # 读取扫描进程退出码，非0代表校验不通过
  SCAN_RESULT=$?
  if [ ${SCAN_RESULT} -ne 0 ]; then
    echo "*错误：SonarQube质量校验未通过，请修复代码中扫描出的问题后再尝试推送*"
    exit 1 # 终止git push流程
  fi
  
  echo "SonarQube质量校验通过，继续推送代码"
  exit 0 # 放行推送流程
  

• 生效验证
  开发者后续正常执行git push命令时，Git会自动先运行上述pre-push钩子触发扫描：如果扫描未通过质量门禁，推送会被直接中断；只有校验通过后代码才会被推送到远端Git仓库。

• 团队统一配置：将pre-push钩子文件放到项目根目录的git-hooks文件夹中提交到Git仓库，所有开发者克隆项目后只要执行一次git config core.hooksPath git-hooks即可自动复用钩子配置，不需要手动逐个修改本地hooks目录
• 服务端强管控：如果不想依赖本地配置，可以将扫描逻辑集成到CI流水线，同时配置Git服务端的pre-receive钩子，开发者推送代码时触发CI调用SonarQube扫描，校验不通过直接在服务端拒绝推送，管控力度更强，也不需要开发者本地做任何适配

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