使用 Git 实现本地与服务器代码仓库同步

在团队协作或个人开发中，保持本地代码与服务器代码库的一致性是一项基础而重要的工作。Git 作为目前最流行的版本控制系统，不仅能够管理代码历史，还能作为同步桥梁，将本地提交安全、高效地推送到远程服务器。本文将详细讲解如何利用 Git 搭建本地与服务器之间的同步机制，并实现自动化部署。

为什么选择 Git 同步？

版本控制：每一次同步都是一次提交，记录完整的变更历史，方便回溯和审计。
协作友好：支持多分支、合并、冲突解决，非常适合团队开发。
安全性：通过 SSH 或 HTTPS 加密传输，权限控制精细。
生态成熟：配合钩子（hooks）可实现持续集成、自动测试、自动部署等高级功能。

前提条件

服务器上已安装 Git（sudo apt install git / yum install git）。
本地机器已安装 Git，并配置好用户信息（git config --global user.name 和 user.email）。
拥有服务器的 SSH 访问权限（推荐使用密钥认证）。

步骤一：在服务器上创建裸仓库（Bare Repository）

裸仓库没有工作区，只存储 Git 对象和引用，是团队协作的标准中心仓库。

# 登录到服务器
ssh user@your-server

# 选择一个存放仓库的目录，例如 /var/repo/
mkdir -p /var/repo/myproject.git
cd /var/repo/myproject.git
git init --bare

注意：裸仓库的命名通常以 .git 结尾，但这并非强制。

步骤二：本地关联远程仓库并推送

在本地项目目录中，添加远程地址并推送初始代码。

1
2
3

cd /path/to/local/project
git remote add origin user@your-server:/var/repo/myproject.git
git push -u origin main

-u 参数将本地 main 分支与远程 main 分支关联，之后只需 git push 即可。

步骤三：配置自动部署（Post-Receive 钩子）

很多时候，我们希望代码推送到服务器后，能自动更新到网站根目录或其他运行环境。这可以通过 Git 钩子实现。

在服务器裸仓库的 hooks 目录下，创建 post-receive 文件：

1
2
3

cd /var/repo/myproject.git/hooks
touch post-receive
chmod +x post-receive

编辑 post-receive，写入部署脚本（以部署到 /var/www/myapp 为例）：

#!/bin/bash
# 指定目标部署目录
DEPLOY_DIR="/var/www/myapp"

# 如果部署目录不存在则克隆，否则拉取更新
if [ ! -d "$DEPLOY_DIR/.git" ]; then
    git clone /var/repo/myproject.git $DEPLOY_DIR
else
    cd $DEPLOY_DIR
    git pull
fi

# 可在此添加其他部署命令，如 npm install、composer install、重启服务等
# cd $DEPLOY_DIR && npm install && pm2 reload app