1. 概述
Git LFS（Large File Storage）用于管理游戏开发中的大文件（模型、贴图、音频、视频），避免 Git 仓库体积膨胀。
常见工具链：
- Git for Windows（提供 Git + LFS）https://git-scm.com/download/win
- SourceTree（可视化 Git 客户端）
2. 安装 Git + Git LFS
2.1 安装说明
安装 Git for Windows 时：
- Git 已包含 Git LFS（新版安装器已集成）
- 无需额外手动初始化 LFS
- 安装时选择 Use Git from the command line and also from 3rd-party software
2.2 验证安装
git --version
git lfs version
3. SourceTree Git 配置
3.1 Git 选择
SourceTree 提供两种 Git：
| 类型 | 说明 |
|---|---|
| Embedded Git | 内置 Git |
| System Git | 系统 Git |
在 SourceTree：
Tools → Options → Git → ✔ Use System Git
确保显示：
Git version: 2.xx.xx.windows.1
LFS: enabled
4. Git LFS 追踪规则配置（核心）
4.1 创建 .gitattributes
在仓库根目录创建：
.gitattributes
写入：
# 模型
*.fbx filter=lfs diff=lfs merge=lfs -text
*.obj filter=lfs diff=lfs merge=lfs -text
*.blend filter=lfs diff=lfs merge=lfs -text# 贴图
*.png filter=lfs diff=lfs merge=lfs -text
*.jpg filter=lfs diff=lfs merge=lfs -text
*.tga filter=lfs diff=lfs merge=lfs -text
*.psd filter=lfs diff=lfs merge=lfs -text# 音频
*.wav filter=lfs diff=lfs merge=lfs -text
*.mp3 filter=lfs diff=lfs merge=lfs -text# 视频
*.mp4 filter=lfs diff=lfs merge=lfs -text
5. 在 SourceTree 中提交 LFS 规则
5.1 添加规则文件
在 SourceTree：
- 打开 File Status
- 找到
.gitattributes - 勾选（Stage）
5.2 提交（Commit）
Add LFS tracking rules
5.3 推送（Push）
上传到远端仓库（GitHub / GitLab / Gitee 等）
6. LFS 生效验证（核心检查）
6.1 查看 LFS 文件列表
git lfs ls-files
6.2 检查文件是否被 LFS 接管
git check-attr filter -- Assets/model.fbx
输出：
filter: lfs
6.3 最终验证
git show HEAD:Assets/model.fbx
如果看到：
version https://git-lfs.github.com/spec/v1
✔ 表示 LFS 完全生效
7. Unity 项目 .gitignore（必须配置）
在 Unity 项目根目录创建：
.gitignore
写入：
# ========== Unity 生成文件 ==========
Library/
Temp/
Obj/
Build/
Builds/
Logs/
UserSettings/# ========== Unity 缓存 ==========
MemoryCaptures/
UnityPackageManager/
UnityCache/# ========== VS / Rider / IDE ==========
.vs/
*.csproj
*.sln
*.user
*.unityproj
*.pidb
*.suo
*.tmp
*.userprefs
*.booproj
*.svd# ========== 操作系统垃圾文件 ==========
.DS_Store
Thumbs.db# ========== Unity 自动生成的元数据 ==========
*.pidb.meta
*.pdb.meta
*.mdb.meta# ========== Crash / Debug ==========
sysinfo.txt# ========== 构建输出 ==========
*.apk
*.aab
*.ipa
*.exe
*.app
*.unitypackage# ========== Rider ==========
.idea/
*.iml# ========== Visual Studio Code ==========
.vscode/# ========== 其他不需要提交的 ==========
*.log
*.orig