如何在Git拉取上游代码时忽略指定文件并避免无用合并提交？

一、核心配置：让Git自动保留本地指定文件 #

针对你修改README.md、添加自定义包，需同步上游且避免冲突/无用提交的场景，最稳妥的方式是给指定文件配置合并时优先保留本地版本的策略，同时用变基（rebase）替代合并（merge）保持提交历史干净。

1. 配置永久生效的合并规则 #

在仓库根目录执行以下命令，让README.md在任何合并操作中自动采用本地版本：

# 配置merge.ours驱动（忽略上游对指定文件的修改）
git config --local merge.ours.driver true
# 将规则写入.gitattributes，推送到仓库后所有克隆者都能继承
echo "README.md merge=ours" >> .gitattributes
# 提交这个配置文件
git add .gitattributes
git commit -m "Set merge strategy to keep local README.md"
git push origin master

如果还有其他需要保留的文件（比如自定义包目录），直接追加到.gitattributes即可：

echo "custom-packages/ merge=ours" >> .gitattributes

2. 无合并提交的同步流程 #

用rebase替代merge，让本地提交始终基于上游最新代码，不会产生多余的合并提交：

# 首次添加上游远程（如果没加过）
git remote add upstream https://github.com/void-linux/void-packages.git
# 拉取上游最新代码
git fetch upstream
# 变基到上游主分支，自动保留本地配置的文件
git rebase upstream/master
# 推送本地分支（变基后需要强制推送，--force-with-lease更安全）
git push origin master --force-with-lease

这个流程会把你的本地提交（比如修改README、添加自定义包）“移动”到上游最新提交之后，提交历史完全线性，没有无用的合并记录。

二、自动化同步（结合Github Actions） #

既然你用Github Actions构建分发，可以写一个定时Action自动完成同步，无需手动操作：

创建.github/workflows/sync-upstream.yml文件，内容如下：

name: Sync Upstream Void Packages
on:
  schedule:
    # 每天UTC凌晨2点自动同步（可自行调整时间）
    - cron: '0 2 * * *'
  workflow_dispatch: # 允许手动触发同步

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 拉取完整历史，确保rebase正常执行

      - name: Configure Git
        run: |
          git config --global user.name "GitHub Actions Bot"
          git config --global user.email "actions@github.com"
          git remote add upstream https://github.com/void-linux/void-packages.git

      - name: Sync with Upstream
        run: |
          git fetch upstream
          # 变基到上游最新版本，自动保留本地指定文件
          git rebase upstream/master
          # 安全推送（仅在本地分支领先远程时强制推送）
          git push origin master --force-with-lease

这个Action会定时拉取上游代码，变基后推送到你的fork，全程无人工干预，且不会产生合并提交。

三、常见问题处理 #

• 如果变基时出现冲突（极少情况，比如你和上游修改了同一个非保留文件）：

  # 解决冲突后
  git add <冲突文件>
  git rebase --continue
  

• 如果你不小心用了merge产生了无用提交，可以用git reset --hard HEAD~1撤销，再重新用rebase同步。

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