Git部署测试服务器：测试与生产环境代码同步最佳实践咨询

这个需求其实是自动化部署里非常常见的场景，我来分享一下经过实践验证的最佳实现方案：

核心就是利用Git分支与服务器目录的一一对应，配合Webhook触发自动化脚本，同时保留生产环境的手动控制权：

• 推送test分支时，Webhook自动触发脚本更新服务器上的test文件夹
• 生产环境则在确认测试无误后，手动执行脚本同步最新代码

1. 初始化服务器上的两个Git仓库 #

先在服务器上分别创建test和生产文件夹，并克隆对应的分支（假设生产分支是main）：

# 初始化测试目录
mkdir /var/www/test && cd /var/www/test
git clone -b test git@your-repo-url.git .

# 初始化生产目录
mkdir /var/www/prod && cd /var/www/prod
git clone -b main git@your-repo-url.git .

这里建议用SSH克隆仓库，避免每次拉取都要输入密码，记得提前配置服务器的SSH公钥到Git仓库的权限设置里。

2. 编写自动化更新脚本 #

测试环境自动更新脚本（update-test.sh） #

这个脚本会被Webhook触发，核心是确保本地代码完全同步远程test分支，推荐用fetch + reset而不是直接git pull，原因后面会解释：

#!/bin/bash
set -e  # 遇到错误立即退出

# 切换到测试目录
cd /var/www/test

# 拉取远程最新代码
git fetch origin test

# 强制重置本地分支到远程test分支的状态，覆盖所有本地修改
git reset --hard origin/test

# 如果你的项目需要构建或安装依赖，可以在这里添加命令
# 比如 npm install && npm run build
# 或者 sudo systemctl restart your-test-service

生产环境手动更新脚本（update-prod.sh） #

生产环境的脚本逻辑类似，只是针对main分支，且手动执行：

#!/bin/bash
set -e

cd /var/www/prod

git fetch origin main
git reset --hard origin/main

# 执行生产环境的部署步骤，比如重启服务、清理缓存等
# sudo systemctl restart your-prod-service
# sudo rm -rf /var/cache/your-app/*

给脚本添加执行权限：

chmod +x update-test.sh update-prod.sh

3. 配置Git仓库的Webhook #

在你的Git仓库管理界面（比如GitHub/GitLab/Gitea）找到Webhook设置，添加一个新的Webhook：

• 触发事件选择「仅推送事件」，并指定只监听test分支的推送
• 目标URL填写服务器上接收Webhook的接口（可以用nginx反向代理到一个简单的脚本，比如用Python/Node.js写的小服务，收到请求后执行update-test.sh）
• 注意配置签名验证，避免恶意请求触发脚本

很多人一开始会想到用git pull origin test，但这个命令本质是git fetch + git merge，在自动化场景下有个致命问题：如果服务器上的test目录存在未提交的本地修改（比如临时调试的代码），merge操作会直接失败，导致更新中断。

而git fetch + git reset --hard origin/test则是直接将本地分支强制重置为远程分支的最新状态，完全忽略本地的任何未提交修改——这正是自动化部署需要的：服务器上的代码应该完全与Git分支一致，所有修改都必须通过Git提交到分支，而不是直接在服务器上修改。

如果你的测试环境确实需要保留某些本地配置文件（比如config.ini），可以把这些文件加入.gitignore，然后在脚本里备份、替换，避免被reset覆盖。

• 权限：确保Webhook执行的用户（比如www-data）对test/prod目录有读写权限，并且能通过SSH拉取Git仓库
• 日志：可以在脚本里添加日志输出，方便排查问题，比如echo "Test environment updated at $(date)" >> /var/log/deploy-test.log
• 回滚：如果生产环境更新出问题，可以用git reset --hard [commit-hash]快速回滚到之前的稳定版本

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