Unity 的 .gitignore
适用于 Unity 的 58 条忽略规则，可直接复制到您的仓库。
跨平台游戏引擎
Unity 的完整 .gitignore
# 由 LFGitignore - https://lfgitignore.com 生成
# 创建：2026-10-31 22:53:07 UTC
# 技术：Unity
### Unity ###
.utmp/
/[Ll]ibrary/
/[Tt]emp/
/[Oo]bj/
/[Bb]uild/
/[Bb]uilds/
/[Ll]ogs/
/[Uu]ser[Ss]ettings/
# 日志档案
*.log
*.blend1
*.blend1.meta
/[Mm]emoryCaptures/
/[Rr]ecordings/
/[Aa]ssets/Plugins/Editor/JetBrains*
*.DotSettings.user
.vs/
# Gradle 缓存
.gradle/
# 导出的对象
ExportedObj/
# Consulo 项目文件
.consulo/
# C# 项目文件
*.csproj
# Unity 项目文件
*.unityproj
# Visual Studio溶液
*.sln
*.slnx
# 解决方案用户选项
*.suo
# 临时文件
*.tmp
# 用户特定设置
*.user
# 用户偏好
*.userprefs
# Unity 项目数据库
*.pidb
# Unity Boo 项目
*.booproj
# Unity 数据文件
*.svd
# 程序调试数据库
*.pdb
*.mdb
*.opendb
*.VC.db
# Unity 元数据
*.pidb.meta
# Unity 调试元数据
*.pdb.meta
# Unity 调试元数据
*.mdb.meta
sysinfo.txt
mono_crash.*
# Android 封装
*.apk
# Android 应用程序包
*.aab
*.unitypackage
*.unitypackage.meta
# 应用程序包
*.app
# Crashlytics 构建
crashlytics-build.properties
InitTestScene*.unity*
/ServerData
/[Aa]ssets/StreamingAssets/aa*
/[Aa]ssets/AddressableAssetsData/link.xml*
/[Aa]ssets/Addressables_Temp*
/[Aa]ssets/AddressableAssetsData/*/*.bin*
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Flow/UnitOptions.db
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Flow/UnitOptions.db.meta
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Core/Property Providers
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Core/Property Providers.meta
/[Aa]ssets/[Ii]nit[Tt]est[Ss]cene*.unity*
/UIElementsSchema/
/[Aa]ssets/[Ss]ceneDependencyCache*
这些 Unity 规则实际上忽略了什么
以下列出了每个忽略模式及其加入 .gitignore 的原因。
通用
| 模式 | 忽略的内容 |
|---|---|
.utmp/ |
This .gitignore file should be placed at the root of your Unity project directory Get latest from https://github.com/github/gitignore/blob/main/Unity.gitignore |
/[Ll]ibrary/ |
通用 |
/[Tt]emp/ |
通用 |
/[Oo]bj/ |
通用 |
/[Bb]uild/ |
通用 |
/[Bb]uilds/ |
通用 |
/[Ll]ogs/ |
通用 |
/[Uu]ser[Ss]ettings/ |
通用 |
*.log |
日志档案 |
Unity 默认支持导入 Blender 资源，无需提交 Blender 的 *.blend1 文件。
| 模式 | 忽略的内容 |
|---|---|
*.blend1 |
Unity 默认支持导入 Blender 资源，无需提交 Blender 的 *.blend1 文件。 |
*.blend1.meta |
Unity 默认支持导入 Blender 资源，无需提交 Blender 的 *.blend1 文件。 |
它们还可能包含极其敏感的数据
| 模式 | 忽略的内容 |
|---|---|
/[Mm]emoryCaptures/ |
它们还可能包含极其敏感的数据 |
录音可能会变得过大
| 模式 | 忽略的内容 |
|---|---|
/[Rr]ecordings/ |
录音可能会变得过大 |
自动生成的 Jetbrains Rider 插件
| 模式 | 忽略的内容 |
|---|---|
/[Aa]ssets/Plugins/Editor/JetBrains* |
自动生成的 Jetbrains Rider 插件 |
Jetbrains Rider 个人层设置
| 模式 | 忽略的内容 |
|---|---|
*.DotSettings.user |
Jetbrains Rider 个人层设置 |
Visual Studio 缓存目录
| 模式 | 忽略的内容 |
|---|---|
.vs/ |
Visual Studio 缓存目录 |
Gradle 缓存目录
| 模式 | 忽略的内容 |
|---|---|
.gradle/ |
Gradle 缓存 |
自动生成 VS/MD/Consulo 解决方案和项目文件
| 模式 | 忽略的内容 |
|---|---|
ExportedObj/ |
导出的对象 |
.consulo/ |
Consulo 项目文件 |
*.csproj |
C# 项目文件 |
*.unityproj |
Unity 项目文件 |
*.sln |
Visual Studio溶液 |
*.slnx |
自动生成 VS/MD/Consulo 解决方案和项目文件 |
*.suo |
解决方案用户选项 |
*.tmp |
临时文件 |
*.user |
用户特定设置 |
*.userprefs |
用户偏好 |
*.pidb |
Unity 项目数据库 |
*.booproj |
Unity Boo 项目 |
*.svd |
Unity 数据文件 |
*.pdb |
程序调试数据库 |
*.mdb |
自动生成 VS/MD/Consulo 解决方案和项目文件 |
*.opendb |
自动生成 VS/MD/Consulo 解决方案和项目文件 |
*.VC.db |
自动生成 VS/MD/Consulo 解决方案和项目文件 |
Unity3D生成元文件
| 模式 | 忽略的内容 |
|---|---|
*.pidb.meta |
Unity 元数据 |
*.pdb.meta |
Unity 调试元数据 |
*.mdb.meta |
Unity 调试元数据 |
Unity3D 生成的崩溃报告文件
| 模式 | 忽略的内容 |
|---|---|
sysinfo.txt |
Unity3D 生成的崩溃报告文件 |
Mono自动生成的文件
| 模式 | 忽略的内容 |
|---|---|
mono_crash.* |
Mono自动生成的文件 |
构建
| 模式 | 忽略的内容 |
|---|---|
*.apk |
Android 封装 |
*.aab |
Android 应用程序包 |
*.unitypackage |
构建 |
*.unitypackage.meta |
构建 |
*.app |
应用程序包 |
Crashlytics 生成的文件
| 模式 | 忽略的内容 |
|---|---|
crashlytics-build.properties |
Crashlytics 构建 |
TestRunner 生成的文件
| 模式 | 忽略的内容 |
|---|---|
InitTestScene*.unity* |
TestRunner 生成的文件 |
在用户自定义之前，Addressables 默认忽略
| 模式 | 忽略的内容 |
|---|---|
/ServerData |
在用户自定义之前，Addressables 默认忽略 |
/[Aa]ssets/StreamingAssets/aa* |
在用户自定义之前，Addressables 默认忽略 |
/[Aa]ssets/AddressableAssetsData/link.xml* |
在用户自定义之前，Addressables 默认忽略 |
/[Aa]ssets/Addressables_Temp* |
在用户自定义之前，Addressables 默认忽略 |
/[Aa]ssets/AddressableAssetsData/*/*.bin* |
默认情况下，Addressables 内容构建将在特定于平台的子文件夹中生成 addressables_content_state.bin 文件，例如：/Assets/AddressableAssetsData/OSX/addressables_content_state.bin |
可视化脚本自动生成的文件
| 模式 | 忽略的内容 |
|---|---|
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Flow/UnitOptions.db |
可视化脚本自动生成的文件 |
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Flow/UnitOptions.db.meta |
可视化脚本自动生成的文件 |
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Core/Property Providers |
可视化脚本自动生成的文件 |
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Core/Property Providers.meta |
可视化脚本自动生成的文件 |
通过播放模式测试自动生成场景
| 模式 | 忽略的内容 |
|---|---|
/[Aa]ssets/[Ii]nit[Tt]est[Ss]cene*.unity* |
通过播放模式测试自动生成场景 |
UI Toolkit 自动生成的文件
| 模式 | 忽略的内容 |
|---|---|
/UIElementsSchema/ |
UI Toolkit 自动生成的文件 |
Assets 文件夹中自动生成的缓存
| 模式 | 忽略的内容 |
|---|---|
/[Aa]ssets/[Ss]ceneDependencyCache* |
Assets 文件夹中自动生成的缓存 |
如何将此 .gitignore 用于 Unity
- 复制上面的Unity规则，或者直接下载文件。
- 在 Git 仓库根目录创建名为 .gitignore 的文件，并将规则粘贴进去。
- 如果其中一些文件已被跟踪，请运行 git rm -r --cached . 然后再次提交 - Git 仅将忽略规则应用于未跟踪的文件。
- 提交 .gitignore 以便团队中的每个人都共享相同的规则。