macOS上Git自动化部署需分本地验证与远程触发：本地用pre-commit/commit-msg检查代码与提交信息，远程通过Webhook调用测试机接口执行git pull等部署命令，并注意SSH密钥、权限、日志与异步响应。
在 macOS 上用 Git 钩子实现自动化部署测试环境，核心是分清本地验证和远程触发两个环节：本地用 pre-commit 或 commit-msg 做代码准入检查，远程（如 GitLab/GitHub/码云）用 Webhook 触发服务器上的部署脚本。macOS 本身不运行服务端钩子，但可作为客户端参与全流程。
1. 本地 Git 钩子：提交前自动检测
确保代码质量再进仓库，避免无效推送浪费 CI 资源：
- 进入项目根目录，确认
.git/hooks/可写：ls -l .git/hooks/ - 创建可执行的
pre-commit文件（不带后缀），内容示例：#!/bin/sh # 检查 JS 是否通过 ESLint if command -v eslint > /dev/null; then eslint --quiet --ext .js,.jsx src/ || { echo "❌ ESLint 失败，请修复"; exit 1; } fi <h1>检查提交信息是否含 JIRA ID（如 PROJ-123）</h1><p>if ! grep -qE '^[A-Z]+-[0-9]+' "$1"; then echo "❌ 提交信息需包含任务编号，例如 'PROJ-123: fix login bug'" exit 1 fi</p><p>echo "✅ 提交检查通过" </p> - 赋予执行权限：
chmod +x .git/hooks/pre-commit
2. 远程 Webhook：推送后自动部署到测试机
Git 服务（如 GitLab）在收到 git push 后，向你指定的 URL 发送 HTTP 请求，macOS 测试机需提供一个轻量接口接收并触发部署：
- 在测试机上准备一个 PHP/Python/Node.js 接口（以 PHP 为例），放在 Web 服务器（如内置 Apache 或 nginx）下，比如
/var/www/html/webhook.php - 接口需做基础校验（Token + 白名单 IP）：
$valid_token = 'your-secret-token-here'; $valid_ip = ['192.168.1.100', '10.0.0.5']; // Git 服务器出口 IP if ($_GET['token'] !== $valid_token || !in_array($_SERVER['REMOTE_ADDR'], $valid_ip)) { http_response_code(403); exit('Forbidden'); } - 校验通过后，执行部署命令（建议用非交互式、带日志）：
file_put_contents('/tmp/deploy.log', date('Y-m-d H:i:s') . " triggered\n", FILE_APPEND); exec('cd /path/to/your/project && git pull origin main && npm install && npm run build 2>&1', $output); file_put_contents('/tmp/deploy.log', implode("\n", $output) . "\n", FILE_APPEND);
3. macOS 端辅助配置要点
让整个流程在 macOS 上稳定跑起来，注意这几个实际细节：
-
SSH 密钥免密拉取：Webhook 中的
git pull是以 Web 服务器用户（如_www或www-data）身份执行的，需为该用户配置 SSH key，并添加到 Git 托管平台的部署密钥中 -
路径与权限：PHP 的
exec()默认禁用部分函数，检查disable_functions配置；确保 Web 用户对项目目录有读写权限（sudo chown -R _www:_www /path/to/project） - 避免阻塞请求：Webhook 接口响应应尽快返回（如异步写入标记文件 + 后台定时器轮询执行），否则 Git 平台可能超时重试
- 日志追踪：所有关键步骤（收到请求、执行命令、错误输出）都写入明确日志，便于排查失败原因
整套流程不需要 Jenkins 或复杂 CI 工具，适合中小团队快速落地。重点不在“全自动化”，而在“每一步可观察、可中断、可回退”。
