将大文件添加到 Git LFS (Large File Storage)

Git LFS 是一个 Git 扩展,用于更有效地处理大文件。以下是将大文件添加到 Git LFS 的步骤:

1. 安装 Git LFS

首先,你需要安装 Git LFS:

bash 复制代码
# 在 macOS 上 (使用 Homebrew)

brew install git-lfs

# 在 Ubuntu/Debian 上

apt-get install git-lfs

# 在 Windows 上 (使用 Chocolatey)

choco install git-lfs

# 使用 Git LFS 安装程序

# 从 https://git-lfs.github.com/ 下载并安装

2. 在你的仓库中设置 Git LFS

在你的 Git 仓库中初始化 LFS:

bash 复制代码
cd your-repository

git lfs install

3. 指定要通过 LFS 追踪的文件类型

使用 git lfs track 命令指定要通过 LFS 管理的文件类型:

bash 复制代码
# 跟踪特定扩展名

git lfs track "*.psd"

git lfs track "*.zip"

git lfs track "*.pdf"

# 跟踪特定文件

git lfs track "path/to/large-file.bin"

# 跟踪特定目录中的所有文件

git lfs track "large-directory/**"

这些命令会更新 .gitattributes 文件,你需要确保将此文件添加到 Git 中:

bash 复制代码
git add .gitattributes

4. 添加和提交大文件

现在你可以正常添加和提交文件,被跟踪的大文件将自动通过 LFS 处理:

bash 复制代码
git add large-file.psd

git commit -m "Add large design file"

5. 将现有的大文件迁移到 LFS

如果你已经在 Git 仓库中有大文件,想要将它们迁移到 LFS:

bash 复制代码
# 首先设置跟踪

git lfs track "*.large-extension"

# 然后使用 git lfs migrate

git lfs migrate import --include="*.large-extension" --everything

6. 推送到远程仓库

推送到远程仓库时,LFS 文件将被自动处理:

bash 复制代码
git push origin main

7. 检查 LFS 跟踪的文件

查看当前仓库中 LFS 正在跟踪的文件类型:

bash 复制代码
git lfs track

查看已被 LFS 管理的文件:

bash 复制代码
git lfs ls-files

注意事项

  1. 确保远程仓库支持 Git LFS(GitHub、GitLab、Bitbucket 等主流平台都支持)
  1. 大多数 Git 托管服务对 LFS 存储有容量限制或额外收费
  1. 团队中的所有开发者需要安装 Git LFS
  1. .gitattributes 文件应当被提交到仓库中
  1. 迁移现有文件到 LFS 会重写历史,需谨慎操作,特别是在共享仓库中
相关推荐
徐子元竟然被占了!!2 小时前
Git学习
git·学习·elasticsearch
l1o3v1e4ding3 小时前
windows安装Claude Code,并接入Deepseek-v4模型 ,提供离线安装包
git·npm·node.js·claude code·cc-switchcc
Dontla14 小时前
git bash打开Claude code报错:Claude Code on Windows requires git-bash.(别把git装其他位置,严格按照默认安装)找不到claude code
windows·git·bash
一个梦醒了14 小时前
安装git bash选项推荐
开发语言·git·bash
呆萌的代Ma18 小时前
Git不强行推送,撤销最近几次的提交
git
透明的玻璃杯20 小时前
git应用
git
炸炸鱼.1 天前
Git+Jenkins实战(一):从零搭建自动化发布与回滚系统(附完整代码)
git·jenkins
言6661 天前
要忽略前端依赖包node_modules的文件在目录下 git暂存区消失
git
胡小禾1 天前
Git Worktree
git
程序员小羊!1 天前
18 GIt
git