如何将私有仓库文件通过Gist公开并推送到两个Git远程仓库？

直接将主仓库的main分支推送到Gist仓库不可行，因为Gist本质是一个独立的Git仓库，它的根目录仅包含你要共享的那个文件；而你的主仓库根目录有多个文件，分支内容完全不匹配，推送会失败或覆盖Gist原有内容（你之前的推送没生效大概率是因为Gist仓库的分支历史和主仓库冲突，Git自动拒绝了推送）。

下面是三种可行的实现方案：

方案一：使用独立分支维护Gist内容 #

专门创建一个分支，只保留需要共享的文件，推送到Gist仓库：

1. 在主仓库本地创建并切换到新分支：

git checkout -b gist-shared

2. 清空分支内的所有文件（只保留目标文件）：

git rm -rf .
git add shared_file.md
git commit -m "Init Gist branch with shared_file.md"

3. 将该分支推送到Gist远程（注意将本地分支映射到Gist的默认分支main）：

git push -u gist gist-shared:main

4. 后续更新流程：
   • 在主仓库main分支修改shared_file.md，提交并推送到原远程
   • 切换到gist-shared分支，同步最新文件：

     git checkout main -- shared_file.md
     git commit -m "Sync shared_file.md from main"
     git push gist
     

方案二：使用Git子模块 #

将Gist仓库作为子模块嵌入主仓库，实现文件的关联同步：

1. 在主仓库中添加Gist作为子模块：

git submodule add git@gist.github.com:<gist-code>.git gist-module

2. 将主仓库根目录的shared_file.md移动到子模块目录：

mv shared_file.md gist-module/
git add .
git commit -m "Move shared_file to Gist submodule"

3. 进入子模块目录，提交并推送到Gist：

cd gist-module
git add shared_file.md
git commit -m "Update shared file"
git push origin main
cd ..
git add gist-module
git commit -m "Update submodule reference"
git push origin main

4. 后续更新时，先修改子模块内的文件，推送Gist后，再回到主仓库提交子模块的版本更新并推送原仓库。

方案三：使用Git钩子自动同步 #

通过post-commit钩子，在主仓库提交后自动同步文件到Gist：

1. 本地单独克隆Gist仓库到某个目录（比如~/my-gist-repo）：

git clone git@gist.github.com:<gist-code>.git ~/my-gist-repo

2. 在主仓库的.git/hooks/目录下创建post-commit脚本：

#!/bin/bash
# 替换为你的主仓库和Gist本地仓库路径
MAIN_REPO_PATH="/path/to/your/main/repo"
GIST_REPO_PATH="~/my-gist-repo"

# 复制最新文件到Gist仓库
cp "${MAIN_REPO_PATH}/shared_file.md" "${GIST_REPO_PATH}/"

# 提交并推送Gist
cd "${GIST_REPO_PATH}"
git add shared_file.md
COMMIT_MSG="Sync from main repo: $(git --git-dir="${MAIN_REPO_PATH}/.git" log -1 --format='%h %s')"
git commit -m "${COMMIT_MSG}"
git push origin main

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

chmod +x .git/hooks/post-commit

之后在主仓库提交shared_file.md后，钩子会自动完成Gist的同步。

方案对比 #

• 分支方案：操作简单，无额外依赖，但需手动切换分支同步，适合更新频率低的场景
• 子模块方案：Git原生支持，结构清晰，但子模块操作有一定学习成本，适合长期维护的场景
• 钩子方案：完全自动同步，无需手动操作，但需要配置脚本，适合更新频繁的场景

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