Overleaf GitHub同步单文件大小限制问题与工作流优化咨询

核心思路 #

保留你现有的分支拆分逻辑，通过工具优化和自动化消除手动操作的繁琐步骤，同时避免合并时误删大文件的问题。

方案1：用Git Worktree消除分支切换成本 #

你当前最繁琐的操作是来回切换master和manuscript分支，用Git Worktree可以在同一个仓库下创建两个独立的工作目录，分别对应两个分支，操作互不干扰：

• 在主仓库目录下执行命令 git worktree add ../paper-manuscript manuscript，执行完成后会在上层目录生成paper-manuscript文件夹，该目录直接对应manuscript分支，不需要切换分支即可操作
• 需要把主分支的LaTeX改动同步到Overleaf时，直接进入paper-manuscript目录，执行 git merge master && git push paper 即可
• Overleaf有在线编辑改动时，也直接进入paper-manuscript目录执行 git pull paper manuscript，之后回到主仓库目录执行 git merge ../paper-manuscript 即可拉取所有LaTeX文件的改动，不会影响主分支的代码、数据等大文件，无需手动cherry-pick。

方案2：封装脚本实现一键操作 #

把重复的同步命令封装为可执行脚本，无需每次手动输入多段命令：

同步主分支改动到Overleaf脚本（命名为push_to_overleaf.sh） #

#!/bin/bash
# 请替换为你自己的实际路径
MANUSCRIPT_DIR="/path/to/paper-manuscript"
cd $MANUSCRIPT_DIR
# 先拉取远端最新改动避免冲突
git pull paper manuscript
# 合并主分支的LaTeX改动
git merge master -m "sync LaTeX changes from master"
# 推送到Overleaf关联的远程仓库
git push paper manuscript

拉取Overleaf改动到主分支脚本（命名为pull_from_overleaf.sh） #

#!/bin/bash
# 请替换为你自己的实际路径
MAIN_REPO_DIR="/path/to/your/main/repo"
MANUSCRIPT_DIR="/path/to/paper-manuscript"
cd $MANUSCRIPT_DIR
git pull paper manuscript
cd $MAIN_REPO_DIR
git merge $MANUSCRIPT_DIR -m "sync LaTeX edits from Overleaf"

脚本编写完成后执行 chmod +x push_to_overleaf.sh pull_from_overleaf.sh 赋予执行权限，之后需要同步时直接运行对应脚本即可。

方案3：GitHub Actions实现全自动化同步 #

如果完全不想手动执行同步操作，可以配置GitHub Actions实现双向自动同步：

• 配置触发规则：主分支有.tex、.bib、.cls等LaTeX相关后缀的文件改动时，自动将这些文件同步到manuscript分支，推送到关联的paper仓库，Overleaf刷新即可获取最新内容
• 配置定时巡检任务：每隔1~2小时拉取paper仓库的manuscript分支改动，如果检测到Overleaf的在线编辑内容，自动向主分支提交PR，你只需审核后点击合并即可，全程无需手动操作分支。
• 额外优化：主分支的大文件可以用Git LFS管理，manuscript分支不跟踪这些大文件，同步到Overleaf的仓库完全不会包含大文件，不会触发50MB单文件限制。

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