将大文件添加到 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 会重写历史,需谨慎操作,特别是在共享仓库中
相关推荐
vibecoding日记3 天前
为什么我就想要「线性历史 + Signed Commits」,GitHub 却把我当猴耍 🤬🎙️
git·编程工具
程序员小崔日记3 天前
如何将代码轻松上传到 Gitee?Git 使用全攻略!
git·gitee·上传
Bigger4 天前
为什么你的 Git 提交需要签名?—— Git Commit Signing 完全指南
git·开源·github
DianSan_ERP5 天前
电商API接口全链路监控:构建坚不可摧的线上运维防线
大数据·运维·网络·人工智能·git·servlet
红豆子不相思5 天前
Tomcat 环境搭建与集群实战
服务器·git·tomcat
杰哥技术分享5 天前
Git 仓库迁移技术文档:从 CODING.net 迁移至腾讯云 CNB
git
梅孔立5 天前
Ansible 100 台服务器一键管控实战 进阶版
服务器·git·ansible
qq_426003966 天前
git切换当前分支到远程分支
git
ON10N6 天前
100% 纯 Vibe Coding,我是怎么用 AI 撸出一个 VS Code 插件的
git·ai编程·visual studio code