如何将Gitlab仓库中的单个文件镜像同步至Github仓库？

方法一：用GitHub Actions定时/触发式拉取单个文件 #

这种方式不用镜像整个仓库，只同步指定目标文件，还支持自动触发更新，完全适配你的需求。

步骤1：确定GitHub仓库的文件存放路径 #

先在你的GitHub仓库里选好要放同步文件的位置，比如./scripts/config.json，如果路径不存在，提前手动创建对应的目录或空文件。

步骤2：创建GitHub Actions工作流 #

在你的GitHub仓库的.github/workflows目录下新建一个yaml文件，比如sync-gitlab-file.yml，把下面的代码填进去（注意替换占位符内容）：

name: Sync GitLab File to GitHub
on:
  schedule:
    # 每小时同步一次，可根据需求调整cron表达式，比如每天凌晨跑就写'0 0 * * *'
    - cron: '0 * * * *'
  workflow_dispatch: # 手动触发开关，方便测试同步效果
jobs:
  sync-file:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取GitHub仓库代码
        uses: actions/checkout@v4
        with:
          persist-credentials: false # 避免后续push时权限冲突

      - name: 从GitLab拉取目标文件
        run: |
          # 替换成你的GitLab文件原始地址，分支和路径要对应
          GITLAB_FILE_URL="https://gitlab.com/[你的协作者用户名]/[仓库名]/raw/[分支名]/path/to/source-file.ext"
          
          # 如果GitLab仓库是私有的，先做这两步：
          # 1. 去GitLab个人设置生成PAT令牌，勾选read_repository权限
          # 2. 在GitHub仓库的Settings>Secrets and variables>Actions里新建GITLAB_PAT变量，填刚才的令牌
          # 然后把下面两行注释打开，替换掉公开仓库的curl命令
          # GITLAB_PAT="${{ secrets.GITLAB_PAT }}"
          # curl -H "Private-Token: $GITLAB_PAT" -o ./scripts/config.json $GITLAB_FILE_URL
          
          # 公开仓库直接用这条命令，把目标路径改成你自己的
          curl -o ./scripts/config.json $GITLAB_FILE_URL

      - name: 提交并推送变更
        run: |
          git config --global user.name "GitHub Actions Bot"
          git config --global user.email "actions@github.com"
          git add ./scripts/config.json
          # 只有文件真的有变更时才提交，避免空提交
          git diff --quiet && git diff --staged --quiet || (git commit -m "同步GitLab最新文件" && git push)
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

步骤3：私有GitLab仓库的额外配置 #

如果你的协作者的GitLab仓库是私有的，按照代码里的注释提示，生成GitLab的PAT令牌，再在GitHub仓库里配置对应的秘密变量即可。

可选：实现GitLab变更即时同步 #

如果不想等定时任务，想让GitLab文件一修改就同步到GitHub，可以给GitLab仓库加个Webhook：

1. 打开GitLab仓库的Settings > Webhooks，新建Webhook，URL填：https://api.github.com/repos/[你的GitHub用户名]/[仓库名]/dispatches，请求方法选POST。
2. 触发事件只选Push events，并指定要监听的文件路径（比如只监听目标文件所在的目录）。
3. 请求体填：

{
  "event_type": "sync-gitlab-file"
}

4. 最后把GitHub工作流里的on部分改成：

on:
  repository_dispatch:
    types: [sync-gitlab-file]
  workflow_dispatch:

这样GitLab里目标文件一变更，就会立刻触发GitHub的同步动作。

方法二：稀疏检出子模块（适合同步整个目录） #

如果目标文件和其他相关文件在同一个目录，用稀疏检出的子模块更方便，只拉取需要的目录，比镜像整个仓库轻量化很多：

1. 本地添加GitLab仓库作为子模块并设置稀疏检出：

git submodule add https://gitlab.com/[协作者用户名]/[仓库名].git ./gitlab-sync-dir
git config submodule.gitlab-sync-dir.sparseCheckout true
echo "path/to/target-dir/" >> .git/modules/gitlab-sync-dir/info/sparse-checkout
git submodule update --init --force

2. 然后在GitHub Actions里定时更新子模块，新建工作流文件update-submodule.yml：

name: Update GitLab Submodule
on:
  schedule:
    - cron: '0 * * * *'
  workflow_dispatch:
jobs:
  update-submodule:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: true
      - name: 更新子模块
        run: |
          git submodule update --remote --merge
          git config --global user.name "GitHub Actions Bot"
          git config --global user.email "actions@github.com"
          git add ./gitlab-sync-dir
          git diff --quiet && git diff --staged --quiet || (git commit -m "从GitLab更新子模块" && git push)
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

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