git-lfs的安装配置，解决大文件存储问题

达子6662025-12-12 9:09

git-lfs的安装配置，解决大文件存储问题

- 1.下载安装
- 2.软件配置
- - [2.1安装并初始化 LFS（仅首次）](#2.1安装并初始化 LFS（仅首次）)
  - [2.2 配置追踪大文件类型](#2.2 配置追踪大文件类型)
  - [2.3 提交追踪规则](#2.3 提交追踪规则)
  - [2.4 添加并提交大文件](#2.4 添加并提交大文件)
  - [2.5 推送到远程（LFS 自动处理大文件）](#2.5 推送到远程（LFS 自动处理大文件）)
- 3.常用指令

1.下载安装

cpp 复制代码

curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh| sudo bash
sudo apt-get update
sudo apt-get install git-lfs
git lfs install

验证安装：

cpp 复制代码

git lfs version

2.软件配置

2.1安装并初始化 LFS（仅首次）

cpp 复制代码

git lfs install

2.2 配置追踪大文件类型

cpp 复制代码

git lfs track "*.bin" "*.tar.xz"

2.3 提交追踪规则

cpp 复制代码

git add .gitattributes
git commit -m "用来配置 LFS 追踪的规则"

2.4 添加并提交大文件

cpp 复制代码

git add large_model.bin
git commit -m "添加大模型文件"

2.5 推送到远程（LFS 自动处理大文件）

cpp 复制代码

git push origin main

注意以下几点：

历史大文件需迁移：若之前已用普通 Git 提交过大文件，需执行

cpp 复制代码

git lfs migrate import --include="*.bin,*.tar.xz"
git push origin main --force

.gitattributes 必须提交：否则远程不会识别 LFS 规则。

团队协作需拉取 LFS 文件 ：新成员克隆后执行 git lfs pull 获取实际文件。

3.常用指令

全局启用（对当前用户的所有仓库）：git lfs install

仅对当前仓库启用：git lfs install --local

克隆时不自动下载 LFS 对象（需要手动 git lfs pull）：git lfs install --skip-smudge

如需撤销：git lfs uninstall（全局）；对单个仓库撤销请在该仓库内使用 git lfs uninstall --local