Git 上传大文件

### Git 上传大文件 在使用Git管理代码版本的过程中，我们常常会遇到一些特殊情况，比如需要上传较大的文件。本文将详细介绍在Mac上使用Git上传大文件的方法与技巧，并提供具体的步骤指南。 #### 遇到的问题 当你尝试通过Git上传大文件时，可能会遇到以下错误信息： ```bash remote:error: GH001: Large files detected. remote:error: Trace: 7b7de6b9372ee392e0f3961b05ea6f33 remote:error: See http://git.io/iEPt8g for more information. remote:error: File *.framework/Versions/A/* is 207.25MB; this exceeds GitHub's file size limit of 100.00MB ``` 这些错误信息表明，你试图上传的文件超过了GitHub的大小限制。GitHub对单个文件的最大大小限制为100MB，超过这个限制的文件无法直接通过Git上传。 #### 解决方案 针对这一问题，目前有两种主要的解决方案：一是删除或排除大文件，二是使用Git LFS (Git Large File Storage)。 ##### 1. 删除大于100M的文件，不上传大文件 如果你确定不需要将大文件存储在版本控制系统中，可以采取以下步骤来删除或排除它们： - **删除磁盘缓存** 使用命令 `git rm --cached <filename>` 或 `git rm -r --cached <directory>` 来删除文件的缓存。 - **从Commit记录中移除** 如果文件已经被提交到了版本库中，可以使用命令 `git commit --amend --no-edit --reset-author` 来撤销最后一次提交，并使用 `git checkout <commit> -- <filename>` 恢复特定版本的文件。 - **推送至远程服务器** 在完成以上操作后，使用 `git push origin master` (如果是第一次推送) 或 `git push` 将更改推送到远程服务器。 ##### 2. 使用Git LFS突破大文件上传限制 如果你需要将大文件纳入版本控制，推荐使用Git LFS。Git LFS 是一个 Git 扩展，用于替代 Git 处理大型文件的方式，它只存储文件元数据，而将实际文件内容保存在远程服务器上。 - **安装Git LFS** 对于Mac用户，推荐使用Homebrew安装： ```bash brew install git-lfs ``` - **初始化Git LFS** 打开终端，切换到包含大文件的Git仓库目录，运行命令 `git lfs install` 来初始化Git LFS。 - **追踪单个文件** 使用命令 `git lfs track "<filename>"` 来指定需要使用Git LFS管理的大文件。例如，如果你想追踪所有的PSD文件，可以执行 `git lfs track "*.psd"`。 - **添加并提交追踪文件** 首先需要将`.gitattributes` 文件添加到版本库中： ```bash git add .gitattributes git commit -m "track *.psd files using Git LFS" ``` 然后提交其他文件： ```bash git add . git commit -m "submit other files" ``` - **验证追踪状态** 运行 `git lfs ls-files` 来检查文件是否已被正确追踪。 - **推送至远程仓库** 最后一步是将文件推送到远程仓库： ```bash git push origin master ``` #### 注意事项 - **上传成功后的拉取问题** 如果在上传大文件后，拉取工程时遇到错误，例如文件中出现了类似 `version https://git-lfs.github.com/spec/v1` 的信息，这可能是由于某些文件追踪失败导致的。解决方法是删除远程仓库中的对应文件，然后按照上述步骤重新进行。 - **追踪framework文件** 对于超过100M的framework文件，可以使用命令 `git lfs track "*.framework/Versions/A/*"` 来追踪。这是因为macOS系统会将framework视为一个文件夹而不是单一文件。 通过以上步骤，你可以有效地管理和上传大文件，避免因文件大小限制而导致的问题。Git LFS 的使用大大提升了开发者处理大文件的能力，使得项目版本控制更加灵活高效。