Windows 系统通过 Git LFS 向 Gitee 推送大文件操作指南
Gitee 限制单文件上传不超过 300M。本文介绍通过 Git LFS 突破限制的方法。
一、安装 Git LFS 工具
-
下载安装包 访问 Git LFS 官网,点击 "Download for Windows" 下载最新版本安装包(.exe 文件)。
-
安装 Git LFS 双击下载的安装包,按提示完成安装(默认会自动关联 Git,无需额外配置)。
-
验证安装 打开 命令提示符(CMD) 或 PowerShell,输入以下命令验证:
git lfs version
若显示版本号,则安装成功。
二、在本地仓库配置 LFS
- 进入本地仓库目录 用命令行导航到项目文件夹,例如:
cd D:\your-project-folder # 替换为你的仓库路径
或者在文件夹空白处按住 Shift 右键,选择 "在此处打开 PowerShell 窗口"。
- 初始化 LFS 在仓库中执行以下命令,启用 LFS 支持:
git lfs install
出现 "Git LFS initialized." 提示,即表示初始化成功。
三、跟踪大文件类型
- 配置需要跟踪的大文件格式 根据大文件实际格式,执行相应命令。例如,若要上传 .zip、.mp4、.iso 等大文件,执行:
# 跟踪所有 .zip 文件(可根据需要添加其他格式)
git lfs track "*.zip"
git lfs track "*.mp4"
git lfs track "*.iso"
- 提交跟踪配置文件 LFS 的跟踪规则会保存在 .gitattributes 文件中,需将其提交到仓库:
git add .gitattributes
git commit -m "配置 LFS 跟踪大文件"
git push origin main # 推送到远程仓库(main 替换为你的分支名)
四、上传大文件到 Gitee
-
复制大文件到本地仓库目录 将超过 300MB 的大文件(如 large_file.zip)放到项目文件夹中。
-
提交大文件 使用 Git 命令提交并推送大文件:
# 添加大文件
git add large_file.zip # 替换为你的大文件名
# 提交到本地仓库
git commit -m
git push origin main


