GLF(Git Large File Storage)安裝使用
使用GitHub desktop上傳大于100mb的文件時報錯
?The following files are over 100MB. lf you commit these files, you will no longer beable to push this repository to GitHub.com.term.rarWe recommend you avoid committing these files or use Git LFS to store large files onGitHub.
Windows:可以從 Git LFS 下載并安裝Git Large File Storage
安裝成功
如何確認是否本地安裝Git LFS 成功
具體操作過程:
下面是詳細的后續步驟,每一步都會標明是在本地操作還是在 GitHub 上驗證的。
本地倉庫指與github中遠程連接的倉庫,本文不再贅述
【本地操作】
-
打開命令行工具 使用 Git Bash、CMD 或 PowerShell 打開終端,并切換到你倉庫所在的目錄。例如:
?cd C:\path\to\your\repository
-
初始化 Git LFS 在倉庫目錄下運行以下命令,確保 Git LFS 被初始化:
?git lfs install
此步驟會配置 Git LFS 鉤子,確保后續對大文件的處理正確。
-
告訴 Git LFS 跟蹤大文件 運行以下命令,指定需要用 Git LFS 管理的文件(此處以
.rar
文件為例):?git lfs track "Al.rar"
執行后,會在倉庫根目錄生成一個名為
.gitattributes
的文件,其中包含類似下面的內容:?Al.rar filter=lfs diff=lfs merge=lfs -text
-
添加并提交 .gitattributes 文件 將
.gitattributes
文件添加到暫存區并提交,這樣其他協作者在克隆倉庫時也會得到 Git LFS 的跟蹤設置:?git add .gitattributesgit commit -m "Track large files with Git LFS"
-
添加并提交大文件 接下來,將大文件添加到 Git 倉庫并提交。注意,如果文件名中包含特殊字符(如括號),可以用轉義符或直接使用引號:
?git add "Al.rar"git commit -m "Add large file via Git LFS"
-
推送到 GitHub 將所有本地更改推送到遠程 GitHub 倉庫。Git LFS 會將大文件上傳到專門的存儲區域:
?git push origin <branch-name>
請將
<branch-name>
替換為你實際使用的分支名稱(例如main
或master
)。
【在 GitHub 上的驗證】
-
驗證文件是否由 Git LFS 管理
-
登錄 GitHub 后,進入你的倉庫頁面。
-
瀏覽對應文件(
Al.rar
)的詳情頁面,GitHub 會顯示該文件由 Git LFS 管理的信息。 -
另外,你可以在倉庫的 "Insights" 或 "Settings" 中查看 Git LFS 的使用情況和統計數據,確認大文件已經正確上傳。
-
-
檢查提交記錄 在 GitHub 的 "Commits" 頁面查看你的提交記錄,確保提交中包含了
.gitattributes
和大文件提交。大文件的提交內容應該是一個指向實際數據的 LFS 指針,而非完整的二進制數據。
報錯
?[0a194db03ea2fb7d010982fec61ff6f4f6e574b828f49d87fdd7c0892a6c59cb] Size must be less than or equal to 2147483648: [422] Size must be less than or equal to 2147483648error: failed to push some refs to “”
Size must be less than or equal to 2147483648
-
其中
2147483648
字節等于 2GB。這意味著單個 Git LFS 管理的文件大小必須小于或等于 2GB。 -
HTTP 狀態碼 422: 錯誤信息中的
[422]
是 HTTP 狀態碼,表示“Unprocessable Entity”(無法處理的實體),即服務器接收到了請求,但請求中的某個部分(這里是文件大小)不符合要求。
解決方案:
拆分成多個小文件,或者進一步壓縮以降低文件大小。于超過 2GB 的文件,GitHub 及 Git LFS 并不適合直接托管。這時可以考慮使用云存儲服務(如 Google Drive 等),然后在倉庫中放置鏈接或說明。