如何实现本地Git仓库文件变更后自动同步至远程仓库？

要实现本地文件变化时自动执行git add/commit/push，核心是用文件系统监控工具触发脚本（Git hooks仅针对Git命令触发，不适合监控原生文件系统变更）。以下是不同操作系统的具体实现方式：

Linux/macOS 方案 #

工具选择 #

• Linux：用inotify-tools（系统原生支持的文件监控工具）
• macOS/Linux通用：用fswatch（跨平台工具，通过包管理器安装）

步骤1：安装监控工具 #

• Linux（Debian/Ubuntu系）：

  sudo apt-get install inotify-tools
  

• macOS：

  brew install fswatch
  

步骤2：编写自动同步脚本 #

Linux（inotify-tools版）

创建auto-git-sync.sh脚本：

#!/bin/bash
# 替换为你的本地仓库绝对路径
REPO_PATH="/home/yourname/your-local-repo"

# 监控目录的创建、删除、修改事件，排除.git文件夹避免循环触发
inotifywait -m -r -e create,delete,modify --exclude '\.git/' "$REPO_PATH" | while read -r dir events file; do
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] 检测到变更: $events - $dir$file"
    cd "$REPO_PATH" || exit 1
    
    # 执行Git同步命令
    git add .
    git commit -m "Auto commit: $(date '+%Y-%m-%d %H:%M:%S')"
    git push origin main # 替换为你的远程分支名（如master）
done

macOS（fswatch版）

创建auto-git-sync.sh脚本：

#!/bin/bash
REPO_PATH="/Users/yourname/your-local-repo"

# 监控目录变更，排除.git文件夹
fswatch -o --exclude '\.git/' "$REPO_PATH" | while read -r event; do
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] 检测到文件系统变更"
    cd "$REPO_PATH" || exit 1
    
    git add .
    git commit -m "Auto commit: $(date '+%Y-%m-%d %H:%M:%S')"
    git push origin main
done

步骤3：运行脚本 #

1. 给脚本添加执行权限：

   chmod +x auto-git-sync.sh
   

2. 后台运行：

   ./auto-git-sync.sh &
   

3. 开机自动启动：
   • Linux：编写systemd服务文件，配置开机自启
   • macOS：通过launchd创建守护进程，实现开机自启

Windows 方案 #

用PowerShell原生监控 #

Windows自带的FileSystemWatcher可直接实现文件监控，无需额外安装工具。

编写PowerShell脚本 #

创建Auto-Git-Sync.ps1：

# 替换为你的本地仓库路径
$repoPath = "C:\Users\yourname\your-local-repo"

# 初始化文件监控器
$watcher = New-Object System.IO.FileSystemWatcher
$watcher.Path = $repoPath
$watcher.IncludeSubdirectories = $true
$watcher.Exclude = ".git"  # 排除.git目录避免循环触发
$watcher.EnableRaisingEvents = $true

# 定义变更处理逻辑
$action = {
    $path = $Event.SourceEventArgs.FullPath
    $changeType = $Event.SourceEventArgs.ChangeType
    Write-Host "[$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')] 检测到$changeType: $path"
    
    Set-Location $repoPath
    git add .
    git commit -m "Auto commit: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
    git push origin main  # 替换为你的远程分支名
}

# 绑定监控事件（创建、删除、修改、重命名）
Register-ObjectEvent $watcher "Created" -Action $action
Register-ObjectEvent $watcher "Deleted" -Action $action
Register-ObjectEvent $watcher "Changed" -Action $action
Register-ObjectEvent $watcher "Renamed" -Action $action

# 保持脚本运行
Write-Host "开始监控$repoPath的文件变更..."
while ($true) { Start-Sleep 1 }

运行脚本 #

1. 右键以管理员身份运行PowerShell，执行脚本：

   .\Auto-Git-Sync.ps1
   

2. 开机自动启动：
   通过「任务计划程序」创建任务，设置触发条件为「登录时」，操作为启动PowerShell并执行该脚本。

关键注意事项 #

• 免密推送配置：必须确保本地Git已配置免密推送（如SSH密钥、Git凭证存储），否则脚本会卡在输入密码环节。
• 排除.git目录：一定要排除对.git文件夹的监控，否则git commit/push操作会修改.git内的文件，导致脚本循环触发。
• 错误处理优化：可在脚本中添加错误判断（比如检查git push的返回值），失败时自动重试，避免单次推送失败导致同步中断。

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