Windows 系统通过 Git LFS 向 Gitee 推送大文件操作指南

前言

在开源协作与代码托管日益普及的当下，Gitee 作为国内领先的代码托管平台，为开发者、团队及企业提供了便捷高效的项目管理与协作空间。为确保平台存储资源的合理分配、保障服务的稳定性与流畅性，同时提升用户整体使用体验，Gitee 制定了单文件上传不超过 300M 的限制规则。这一限制虽能规避因超大文件传输导致的网络拥堵、存储压力过大等问题，但也给需要上传大型资源（如高清视频素材、大型数据集、完整安装包）的用户带来了挑战。

若强行上传超限制文件，不仅会导致上传失败，还可能影响项目进度与团队协作效率。不过，无需为此困扰！本指南将围绕突破 300M 文件上传限制展开，深入介绍通过 Git LFS（大文件存储）、分卷压缩、第三方存储链接引用等实用方案，帮助你轻松应对大文件上传难题，充分发挥 Gitee 的平台优势，让项目资源管理更加灵活高效。

一、安装 Git LFS 工具

1. 下载安装包

访问Git LFS 官网，点击 "Download for Windows" 下载最新版本安装包（.exe 文件）。

1. 安装 Git LFS

双击下载的安装包，按提示完成安装（默认会自动关联 Git，无需额外配置）。

1. 验证安装

打开 命令提示符（CMD） 或 PowerShell，输入以下命令验证：

git lfs version

若显示版本号，则安装成功。

二、在本地仓库配置 LFS

1. 进入本地仓库目录

用命令行导航到项目文件夹，例如：

cd D:\your-project-folder # 替换为你的仓库路径

或者在文件夹空白处按住 Shift 右键，选择 "在此处打开 PowerShell 窗口"。

1. 初始化 LFS

在仓库中执行以下命令，启用 LFS 支持：

git lfs install

出现 "Git LFS initialized." 提示，即表示初始化成功。

三、跟踪大文件类型

1. 配置需要跟踪的大文件格式

根据大文件实际格式，执行相应命令。例如，若要上传 .zip、.mp4、.iso 等大文件，执行：

# 跟踪所有 .zip 文件（可根据需要添加其他格式）

git lfs track "*.zip"

git lfs track "*.mp4"

git lfs track "*.iso"

1. 提交跟踪配置文件

LFS 的跟踪规则会保存在 .gitattributes 文件中，需将其提交到仓库：

git add .gitattributes

git commit -m "配置LFS跟踪大文件"

git push origin main # 推送到远程仓库（main 替换为你的分支名）

四、上传大文件到 Gitee

1. 复制大文件到本地仓库目录

将超过 300MB 的大文件（如 large_file.zip）放到项目文件夹中。

1. 提交大文件

使用 Git 命令提交并推送大文件：

# 添加大文件

git add large_file.zip # 替换为你的大文件名

# 提交到本地仓库

git commit -m "添加大文件large_file.zip"

# 推送到Gitee远程仓库

git push origin main # 分支名根据实际情况修改

1. 认证登录

推送时若弹出认证窗口，输入你的 Gitee 账号和密码；为保证安全，建议使用Gitee 个人令牌进行认证。

五、在 Gitee 仓库开启 LFS

1. 登录 Gitee 官网，进入你的仓库页面。

1. 点击仓库顶部的 「设置」 → 左侧菜单 「LFS 管理」。

1. 点击 「开启 LFS」 按钮（默认可能未开启），确认启用大文件存储功能。

六、注意事项

1. 存储额度：Gitee 免费用户的 LFS 总容量为 5GB，单文件最大支持 5GB，超出需付费扩容。

1. 删除大文件：如需删除 LFS 跟踪的文件，需使用 git lfs rm 命令，否则可能残留缓存。

1. 克隆仓库：其他人克隆仓库时，需先安装 Git LFS，否则大文件无法正常下载（克隆后会自动触发 LFS 拉取）。