将大文件添加到 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 会重写历史,需谨慎操作,特别是在共享仓库中
相关推荐
洋仔3 小时前
Git 底层原理系列 · 第8讲 — HEAD 与 detached HEAD
git·开源
洋仔3 小时前
Git 底层原理系列 · 第4讲 — `git add` 与 `git commit` 底层做了什么
git·开源
猫咪老师QAQ4 小时前
基于 Git Flow 的团队协作与发布流程实践
git
caicai_xiaobai5 小时前
分享一个访问Git Hub的好方法
git
Joy T5 小时前
【Web3】跨链资金池与消息路由:CCIP 智能合约集成实战与权限收束
git·web3·node·智能合约·hardhat
難釋懷6 小时前
Nginx虚拟主机
git·nginx·github
moMo7 小时前
# Git 入门—代码仓库的使用
git·github
一路向北he8 小时前
git仓库创建新分支,上传文件
git
半个落月10 小时前
从零开始理解 Git 核心操作:告别单机开发的“原始时代”
git
东风破_10 小时前
别学 Git 命令了,先搞懂这仨区域:工作区→暂存区→仓库
git