已删除文件是否会出现在通过GitHub发布的Python包中?
Git仓库误提交大文件相关问题解答
问题1:用户克隆仓库时是否会下载已删除的大文件
答案是是。
Git会保留所有提交历史的文件快照,即便你在后续提交中删除了大文件,它仍然存储在.git目录的对象库中。默认执行git clone时会拉取完整的提交历史,所以下载体积会包含该大文件的大小。
问题2:发布为Python包后安装时是否会下载该大文件
答案是绝大多数情况下为否。
Python包的打包流程只会读取你当前工作目录下被指定纳入发布的文件,不会读取Git历史中的存储对象。只要你打包时的工作目录已经删除了该大文件,且没有错误配置将.git目录纳入打包范围,发布的安装包就不会包含这个历史大文件,用户安装时也不会下载。
修复方案
如果你需要降低用户克隆仓库时的下载体积,需要清理Git提交历史中的大文件,推荐操作如下:
- 提前完整备份你的本地仓库,避免操作失误丢失数据
- 安装Git官方推荐的历史清理工具
git-filter-repo,可通过包管理器直接安装,也可执行pip install git-filter-repo安装 - 进入本地仓库目录,执行命令删除指定大文件的所有历史记录:
git filter-repo --path 替换为你的大文件完整路径 --invert-paths - 强制推送清理后的历史到远程仓库:
git push origin --force --all
注意:如果有其他协作者共同维护仓库,需要通知所有协作者删除本地旧仓库,重新拉取清理后的远程仓库,避免旧的提交历史被重新推送回远程。
如果不想修改仓库提交历史,也可以告知需要克隆仓库的用户使用浅克隆命令,仅拉取最新提交,绕过历史大文件:
git clone --depth 1 你的仓库地址
内容的提问来源于stack exchange,提问作者Shubh Agrawal
相关产品推荐
相关产品推荐

