github/gitignore · Unity.gitignore
Template .gitignore do Unity explicado
Explica por que o Unity.gitignore ignora Library, Temp, Obj, Build, Logs, UserSettings e os arquivos de IDE gerados automaticamente, e por que os arquivos .meta devem ser commitados.
O Unity.gitignore pressupõe que fica na raiz do projeto Unity. As regras de pasta do template começam com /, como /[Ll]ibrary/, e ficam fixas na raiz do projeto, então, se o projeto Unity estiver em uma subpasta do repositório, é preciso corrigir os caminhos.
O editor do Unity cria um cache enorme (Library) ao importar assets e também gera automaticamente arquivos de solução para a IDE de scripts. Este template bloqueia esses arquivos que podem ser recriados e ajuda a compartilhar apenas Assets, Packages e ProjectSettings.
Explicação regra por regra
| Padrão | O que ignora e por quê |
|---|---|
/[Ll]ibrary//[Tt]emp//[Oo]bj//[Ll]ogs/.utmp/ | Cache do editor e pastas temporáriasSão os resultados da importação de assets e o cache de compilação. Às vezes chegam a vários GB, e o Unity os cria de novo ao abrir o projeto. |
/[Bb]uild//[Bb]uilds/*.apk*.aab*.app*.unitypackage | Resultados de buildSão os builds do player e os pacotes exportados. Os arquivos de distribuição são gerenciados como release, não no repositório. |
/[Uu]ser[Ss]ettings/*.user*.userprefs*.suo.vs/ | Configurações pessoaisSão o layout do editor, as configurações pessoais e os arquivos de usuário do Visual Studio. |
*.csproj*.unityproj*.sln*.slnx | Arquivos de IDE gerados automaticamenteSão arquivos de projeto e solução que o Unity recria toda vez para o editor de scripts. Se forem commitados, os caminhos diferem entre pessoas e os conflitos são frequentes. |
*.pdb*.mdb*.pdb.meta*.mdb.meta | Símbolos de depuraçãoSão as informações de depuração do Mono e do .NET e seus arquivos meta. |
/ServerData/[Aa]ssets/StreamingAssets/aa*/[Aa]ssets/AddressableAssetsData/link.xml* | Gerados de Addressables e Visual ScriptingSão os resultados de build do Addressables e os arquivos de link gerados automaticamente. São criados de novo a cada build. |
*.blend1*.blend1.metasysinfo.txtcrashlytics-build.properties/[Mm]emoryCaptures//[Rr]ecordings/ | OutrosSão arquivos de backup do Blender, subprodutos de relatórios de falha, capturas do Memory Profiler e resultados do Recorder. |
Cuidados na prática
- Não ignore os arquivos
.meta. O Unity liga as referências entre assets pelo GUID do.meta, então, se eles faltarem, as referências se quebram no projeto de outras pessoas. - Assets binários grandes, como texturas, modelos e áudio, costumam ser gerenciados com Git LFS, não com gitignore.
- Se você usa Visual Studio ou Rider, escolha também os templates VisualStudio e JetBrains; com a opção de remover duplicatas ativada, as regras que se sobrepõem são organizadas.
Template original
Unity.gitignore
# 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## Recommended: add any editor/OS/tool-specific ignore rules from the Global/ templates as needed.# See: https://github.com/github/gitignore/tree/main/Global#.utmp//[Ll]ibrary//[Tt]emp//[Oo]bj//[Bb]uild//[Bb]uilds//[Ll]ogs//[Uu]ser[Ss]ettings/*.log# By default unity supports Blender asset imports, *.blend1 blender files do not need to be commited to version control.*.blend1*.blend1.meta# MemoryCaptures can get excessive in size.# They also could contain extremely sensitive data/[Mm]emoryCaptures/# Recordings can get excessive in size/[Rr]ecordings/# 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*# Jetbrains Rider personal-layer settings*.DotSettings.user# Visual Studio cache directory.vs/# Gradle cache directory.gradle/# Autogenerated VS/MD/Consulo solution and project filesExportedObj/.consulo/*.csproj*.unityproj*.sln*.slnx*.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 reportssysinfo.txt# Mono auto generated filesmono_crash.*# Builds*.apk*.aab*.unitypackage*.unitypackage.meta*.app# Crashlytics generated filecrashlytics-build.properties# TestRunner generated filesInitTestScene*.unity*# Addressables default ignores, before user customizations/ServerData/[Aa]ssets/StreamingAssets/aa*/[Aa]ssets/AddressableAssetsData/link.xml*/[Aa]ssets/Addressables_Temp*# By default, Addressables content builds will generate addressables_content_state.bin# files in platform-specific subfolders, for example:# /Assets/AddressableAssetsData/OSX/addressables_content_state.bin/[Aa]ssets/AddressableAssetsData/*/*.bin*# Visual Scripting auto-generated files/[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# Auto-generated scenes by play mode tests/[Aa]ssets/[Ii]nit[Tt]est[Ss]cene*.unity*# UI Toolkit auto generated files/UIElementsSchema/# Auto-generated cache in Assets folder/[Aa]ssets/[Ss]ceneDependencyCache*
Origem dos templates: github/gitignore/Unity.gitignore @356fd7b (2026-09-11) · CC0-1.0