Unity3D 项目虽然说使用 C# 脚本开发,但毕竟不是 .NET/C# 项目。今天一位小伙伴告诉我说用错了 .gitignore 文件,结果管理仓库时丢了很多重要的文件。
实际上,GitHub 官方提供了大量不同项目类型的 .gitignore 文件,并且有广大的社区支持时时更新,直接前往 GitHub 官网下载是最好的选择了。
适用于 Unity 项目的 .gitignore 模板:
- gitignore/Unity.gitignore at master · github/gitignore
# This .gitignore file should be placed at the root of your Unity project directory
#
# Get latest from https://github.com/github/gitignore/blob/master/Unity.gitignore
#
/[Ll]ibrary/
/[Tt]emp/
/[Oo]bj/
/[Bb]uild/
/[Bb]uilds/
/[Ll]ogs/
/[Uu]ser[Ss]ettings/
# MemoryCaptures can get excessive in size.
# They also could contain extremely sensitive data
/[Mm]emoryCaptures/
# Asset meta data should only be ignored when the corresponding asset is also ignored
!/[Aa]ssets/**/*.meta
# Uncomment this line if you wish to ignore the asset store tools plugin
# /[Aa]ssets/AssetStoreTools*
# Autogenerated Jetbrains Rider plugin
/[Aa]ssets/Plugins/Editor/JetBrains*
# Visual Studio cache directory
.vs/
# Gradle cache directory
.gradle/
# Autogenerated VS/MD/Consulo solution and project files
ExportedObj/
.consulo/
*.csproj
*.unityproj
*.sln
*.suo
*.tmp
*.user
*.userprefs
*.pidb
*.booproj
*.svd
*.pdb
*.mdb
*.opendb
*.VC.db
# Unity3D generated meta files
*.pidb.meta
*.pdb.meta
*.mdb.meta
# Unity3D generated file on crash reports
sysinfo.txt
# Builds
*.apk
*.unitypackage
# Crashlytics generated file
crashlytics-build.properties
# Packed Addressables
/[Aa]ssets/[Aa]ddressable[Aa]ssets[Dd]ata/*/*.bin*
# Temporary auto-generated Android Assets
/[Aa]ssets/[Ss]treamingAssets/aa.meta
/[Aa]ssets/[Ss]treamingAssets/aa/*
注意到 sln 和 csproj 都是忽略的文件吗?这是 Unity 的项目,其他 .NET 项目经常使用的 sln 解决方案管理方式在这里只是辅助手段而已,你可以阅读我的另一篇博客了解更多:
- Unity3D 入门:使用 Visual Studio 开发 Unity C# 脚本,说说根目录的那些 sln 和 csproj 文件 - walterlv
额外的,你可能注意到 Unity 项目里面有大量的 *.meta 文件,是自动生成的,这个要加入到版本管理吗?答案是需要。Unity 创建这些文件是为了给导入的文件添加额外的元数据信息的,毕竟不能直接修改原来的文件。这些信息包含:
- 描述如何导入这个资产文件
- 如何在项目中准备资产
如果你删除了这些文件,那么 Unity 会用默认的元数据信息生成一个对应的 .meta 文件。
其他类型的 .gitignore 文件前往 GitHub 的 gitignore 仓库:
- github/gitignore: A collection of useful .gitignore templates
另外,开启一个新的 Unity 项目时,放一个适用于大多数场景的 .gitattributes 也可以一开始规避一些坑。你可以从下面这位大佬拿到他整理的一个 .gitattribute 文件。
- .gitattributes for Unity3D with git-lfs
参考资料
- unity5 - What is a .meta file and why does Unity create them for all of my assets? - Stack Overflow
本文会经常更新,请阅读原文: https://blog.walterlv.com/post/unity-starter-git-ignore-and-git-attributes.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://blog.walterlv.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 ([email protected]) 。