十分鐘學會GIT倉庫瘦身及GIT LFS遷移說明
這篇文章為大家帶來了GIT倉庫瘦身及GIT LFS遷移說明的相關知識，希望對大家有幫助。
背景
之前一些git專案上 CI/CD，發現jenkins git clone失敗，設定depth及clone時間之類的無果。只能考慮倉庫瘦身之類的策略。發現倉庫有不少的二進位文件，而這些二進位檔案變更還挺頻繁，這種操作會導致git倉庫成倍增長極速膨脹，git本身只適合管理文字檔案。
另外說一則有趣的往事，之前有個同事是圖形編程，這個語言源碼是圖片形式的，而且一個文件又特別大，上git管理，小公司項目變更又頻繁，導致沒多久公司內部搭的git伺服器硬碟居然就給他的幾個git倉庫給佔滿了。
GIT LFS (Large File Storage)
雖然git一直不適合管理二進位文件，不過現在 git 也好像預設提供了git lfs 這個專門用來管理大文件的插件。
基本原理簡單來說就是使用類似一個文件指針（文本）代替實際的文件存儲，git只存儲文件指針的變更歷史而不是整個二進製文件，並且在使用的時候，自動提供hook，方便在如clone、pull、reset等操作會自動去取得這些文件指標的來源二進位文件，同樣更新二進位檔案commit的時候，git 會自動將來源檔案轉成檔案指標進git log，同時原始檔上傳lfs。所以在使用者層面，GIT LFS的使用其實是無感覺的。
遷移
上面簡單介紹了一下GIT LFS，接下來直接將如何遷移，至於為什麼直接講遷移而不是從0開始如何使用LFS。
是因為往往是git倉庫用著用著發現，倉庫好大、clone好慢，然後才是想著用LFS。
遷移需要我們有倉庫的管理員權限，並且將保護分支之類取消保護；
具體LFS遷移主要分為以下幾步。
遷移前最好做好備份，並且和團隊同事溝通好，畢竟操作涉及-f高風險操作，容易背鍋。
GIT LFS 服務端設定
部分自建置git 服務的話，可能需要服務端設定開啟LFS，例如gitlab。
GIT LFS 用戶端安裝
windows 的git安裝包自備了該插件，不需要另外安裝，其他平台可自行安裝，連結。
在命令列嘗試以下命令。
git lfs
如果有類似help文件資訊輸出，就是已經有git lfs客戶端了。
git-lfs/2.11.0 (GitHub; windows amd64; go 1.14.2; git 48b28d97)git lfs <command> [<args>]Git LFS is a system for managing and versioning large files in association with a Git repository. Instead of storing the large files within the Git repository as blobs, Git LFS stores special "pointer files" in the repository, while storing the actual file contents on a Git LFS server. The contents of the large file are downloaded automatically when needed, for example when a Git branch containing the large file is checked out.Git LFS works by using a "smudge" filter to look up the large file contents based on the pointer file, and a "clean" filter to create a new version of the pointer file when the large file's contents change.It also uses a pre-push hook to upload the large file contents to the Git LFS server whenever a commit containing a new large file version is about to be pushed to the corresponding Git server.</args></command>
而後需要執行以下指令設定LFS全域環境，只需要設定一次，同時也會去更新目前倉庫的hooks
git lfs install
#遷移本地歷史倉庫
lfs遷移基本概念：lfs重寫本地歷史—>force push覆寫遠端，達到遷移的效果。
所以我們最好將本地倉庫與遠端同步，並且將所有的遠端分支都創建本地分支；
而後cd到自己本地倉庫，執行以下下命令，–include裡面是glob表達式，自行加入想LFS管理的檔名，–everything代表所有本地分支
git lfs migrate import --include="*.bin,*.lib,*.so,*.dll,*.a,*.param,*.zip,*.gz" --everything
migrate: Sorting commits: ..., done. migrate: Rewriting commits: 100% (193/193), done. develop bacb490a80ea46d73bd3866c2e7cf7ad199ce5eb -> 72884bcb4629417bad73ea3d485d08a0708909cd feature/npu-platform a3645632756becc527c7f4d58514b3c479f824d3 -> e227900a3903b3a6955e4dffee48daeceac6cdff master 1ccdecdcb4b5d6224a6e24c6f87793bfcc15ee4c -> 1d9fc2139600ef3d92a20d65bb5db89021b8c488 0.1.0 07c6b2aa732506f1cc88cedb551f37f376b6efa6 -> 8e55193221dfca9f6bb28ccd9cca85af9c5958c9 1.0.0 0f694efcd7aa9df641836e1ea6eebbb730b940b5 -> 3f9e77575120b6e56b34790c998a362116da75f5 migrate: Updating refs: ..., done.
重寫完本地分支、tag之類的，
我們在這裡可以先執行git lfs ls-files查看有哪些文件被轉成了lfs管理，檢查是否有遺漏
#這個時候無論在哪個分支，都會出現.gitattributes 文件，且都會被添加上類似以下內容。
*.bin filter=lfs diff=lfs merge=lfs -text *.lib filter=lfs diff=lfs merge=lfs -text *.so filter=lfs diff=lfs merge=lfs -text *.dll filter=lfs diff=lfs merge=lfs -text *.a filter=lfs diff=lfs merge=lfs -text *.param filter=lfs diff=lfs merge=lfs -text *.zip filter=lfs diff=lfs merge=lfs -text *.gz filter=lfs diff=lfs merge=lfs -text
同時可以看到我們二進位檔案全部都轉成了以下形式文字
version https://git-lfs.github.com/spec/v1 oid sha256:9171c8350d72ccca6ad60ac80b577157ad1f9fd44ca05744216e02ccbfcdf491 size 10260
確認無誤，之後就可以推送到遠端；
由於lfs的遷移會重寫所有的commit，並且修改hash值，因此需要我們需要加上–froce
這一步驟需要取消保護分支（保護分支無法-f）
git push --force --all
這樣遠端倉庫的lfs遷移就完成了
迁移一些补充说明
- 迁移者的本地仓库lfs文件转源文件：经过以上步骤，由于我们将所有文件都已经转成文件指针，我们需要将文件下载回来才能正常使用该仓库。
需要注意，其他人重新clone 或者同步 lfs迁移过的remote仓库 是不需要该步，只针对迁移作者本地的仓库。
git lfs pull
- 团队中其他成员迁移前的本地仓库同步: 由于远程仓库的历史已经被全部重写，所以无法直接同步，最好是删除本地分支，重新拉取远程分支，如果本地已经有部分commit需要提交，可以重名本地分支，拉取远程再做cherry pick。git tag 同理，删除迁移前的tag。
- 本地仓库清理：上面的迁移成功将二进制文件迁移成git lfs 对象，git log 也不在存储源文件文件变更而是指针变更，但是在本地.git文件夹中仍存在之前不再需要的git log 缓存，执行以下命令做清理。
git reflog expire --expire-unreachable=now --all git gc --prune=now
清理前后仓库对比
lfs直观来讲更多的是针对仓库大clone慢的问题，我这边lfs迁移前后各备份各一个小型远程仓库做测试，
用的测试仓库二进制文件比较小，总大50m内，且变更次数也在个位数。
clone下来的仓库大小对比。
和我预估差不多，总的来说更适合二进制文件频繁变更，如果单纯是文件大，但文件不变更的话，在clone的时候区别不大，毕竟lfs在clone仍有下载源文件的步骤，除开下载，操作文件指针对git来说理论仍会有性能提升，但是可能感知不强。
推荐学习：《Git教程》
以上是十分鐘學會GIT倉庫瘦身及GIT LFS遷移說明的詳細內容。更多資訊請關注PHP中文網其他相關文章！
熱AI工具
Undresser.AI Undress
人工智慧驅動的應用程序，用於創建逼真的裸體照片
AI Clothes Remover
用於從照片中去除衣服的線上人工智慧工具。
Undress AI Tool
免費脫衣圖片
Clothoff.io
AI脫衣器
Video Face Swap
使用我們完全免費的人工智慧換臉工具，輕鬆在任何影片中換臉！
熱門文章
熱工具
記事本++7.3.1
好用且免費的程式碼編輯器
SublimeText3漢化版
中文版，非常好用
禪工作室 13.0.1
強大的PHP整合開發環境
Dreamweaver CS6
視覺化網頁開發工具
SublimeText3 Mac版
神級程式碼編輯軟體(SublimeText3)
git怎麼更新代碼
Apr 17, 2025 pm 04:45 PM
更新 git 代碼的步驟：檢出代碼：git clone https://github.com/username/repo.git獲取最新更改：git fetch合併更改：git merge origin/master推送更改（可選）：git push origin master
git怎麼下載項目到本地
Apr 17, 2025 pm 04:36 PM
要通過 Git 下載項目到本地，請按以下步驟操作：安裝 Git。導航到項目目錄。使用以下命令克隆遠程存儲庫：git clone https://github.com/username/repository-name.git
git怎麼合併代碼
Apr 17, 2025 pm 04:39 PM
Git 代碼合併過程：拉取最新更改以避免衝突。切換到要合併的分支。發起合併，指定要合併的分支。解決合併衝突（如有）。暫存和提交合併，提供提交消息。
git commit怎麼用
Apr 17, 2025 pm 03:57 PM
Git Commit 是一種命令，將文件變更記錄到 Git 存儲庫中，以保存項目當前狀態的快照。使用方法如下：添加變更到暫存區域編寫簡潔且信息豐富的提交消息保存並退出提交消息以完成提交可選：為提交添加簽名使用 git log 查看提交內容
git下載不動怎麼辦
Apr 17, 2025 pm 04:54 PM
解決 Git 下載速度慢時可採取以下步驟：檢查網絡連接，嘗試切換連接方式。優化 Git 配置：增加 POST 緩衝區大小（git config --global http.postBuffer 524288000）、降低低速限制（git config --global http.lowSpeedLimit 1000）。使用 Git 代理（如 git-proxy 或 git-lfs-proxy）。嘗試使用不同的 Git 客戶端（如 Sourcetree 或 Github Desktop）。檢查防火
git怎麼更新本地代碼
Apr 17, 2025 pm 04:48 PM
如何更新本地 Git 代碼？用 git fetch 從遠程倉庫拉取最新更改。用 git merge origin/<遠程分支名稱> 將遠程變更合併到本地分支。解決因合併產生的衝突。用 git commit -m "Merge branch <遠程分支名稱>" 提交合併更改，應用更新。
如何解決PHP項目中的高效搜索問題？ Typesense助你實現！
Apr 17, 2025 pm 08:15 PM
在開發一個電商網站時，我遇到了一個棘手的問題：如何在大量商品數據中實現高效的搜索功能？傳統的數據庫搜索效率低下，用戶體驗不佳。經過一番研究，我發現了Typesense這個搜索引擎，並通過其官方PHP客戶端typesense/typesense-php解決了這個問題，大大提升了搜索性能。
git怎麼刪除倉庫
Apr 17, 2025 pm 04:03 PM
要刪除 Git 倉庫，請執行以下步驟：確認要刪除的倉庫。本地刪除倉庫：使用 rm -rf 命令刪除其文件夾。遠程刪除倉庫：導航到倉庫設置，找到“刪除倉庫”選項，確認操作。
