Gitee 上传大文件（超过 300M）操作指南

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

Gitee 限制单文件上传不超过 300M。本文介绍通过 Git LFS 突破限制的方法。

一、安装 Git LFS 工具

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

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

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

git lfs version

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

二、在本地仓库配置 LFS

1. 进入本地仓库目录 用命令行导航到项目文件夹，例如：

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

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

2. 初始化 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"

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

git add .gitattributes
git commit -m "配置 LFS 跟踪大文件"
git push origin main # 推送到远程仓库（main 替换为你的分支名）

四、上传大文件到 Gitee

1. 复制大文件到本地仓库目录 将超过 300MB 的大文件（如 large_file.zip）放到项目文件夹中。

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

# 添加大文件
git add large_file.zip # 替换为你的大文件名
# 提交到本地仓库
git commit -m 

git push origin main