如何将本地项目推送到多个Bitbucket仓库且仅覆盖指定文件？

核心思路 #

要实现只更新公共文件、保留各仓库独有内容，关键是让Git只处理你需要同步的公共文件，同时不删除远程仓库中本地未跟踪的独有文件。.gitignore无法解决这个问题（因为它只作用于未跟踪文件，远程已提交的独有文件属于已跟踪状态，本地缺失会被Git标记为删除），以下是可行的实操方案：

方案一：多远程仓库+合并策略（推荐） #

这个方法通过给本地项目添加多个远程仓库，结合Git的合并规则，确保公共文件覆盖远程版本，同时保留远程的独有文件：

1. 添加所有Bitbucket仓库为本地远程
   打开本地项目的终端，给每个客户仓库添加远程别名：

   git remote add client1 git@bitbucket.org:你的账号/client1-repo.git
   git remote add client2 git@bitbucket.org:你的账号/client2-repo.git
   # 以此类推添加其他仓库
   

2. 同步公共代码到单个远程仓库的步骤
   对每个客户仓库重复以下操作：

   • 拉取远程仓库的最新代码（不自动提交）：

     git pull client1 main --no-commit
     

     这一步会把远程仓库的所有内容（包括独有文件）拉到本地，避免冲突。
   • 用「本地优先」的合并策略，保留本地公共文件的修改，同时保留远程的独有文件：

     git merge --strategy-option ours HEAD
     

     这个命令会让Git在合并时，公共文件用本地版本覆盖远程版本，而远程的独有文件因为本地没有修改，会被保留下来。
   • 提交合并结果并推送：

     git commit -m "同步公共代码到client1仓库"
     git push client1 main
     

方案二：用.gitattributes定义公共文件的合并规则 #

如果你的公共文件是固定的一批，可以通过配置.gitattributes来自动处理合并逻辑，减少手动操作：

1. 在本地项目根目录创建.gitattributes文件，指定公共文件的合并策略为「本地优先」：

   src/ merge=ours
   common-lib/ merge=ours
   config/common-settings.json merge=ours
   # 列出所有需要同步的公共文件/文件夹
   

2. 之后同步单个仓库时，只需执行拉取、合并、推送即可，Git会自动用本地版本覆盖远程的公共文件：

   git pull client1 main
   git commit -m "同步公共代码到client1仓库"
   git push client1 main
   

   （如果合并时出现冲突，因为我们设置了merge=ours，直接选择保留本地版本即可）

关于.gitignore的说明 #

你之前尝试的.gitignore配置之所以失效，是因为Git的.gitignore只对未被跟踪的文件生效。远程仓库中已提交的独有文件属于「已跟踪状态」，本地没有这些文件时，Git会默认标记为需要删除，这和你的需求矛盾，所以无法通过.gitignore实现目标。

Bitbucket平台层面的配置 #

Bitbucket本身没有专门的配置项实现这个需求，因为这类文件同步规则属于Git的本地操作逻辑，需要通过Git命令或配置来完成。

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