Unity용 .gitignore
저장소에 바로 복사할 수 있는 Unity 제외 규칙 58개.
크로스 플랫폼 게임 엔진
Unity용 전체 .gitignore
# LFGitignore로 생성 - https://lfgitignore.com
# 생성일: 2026-10-13 15:51:10 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 에셋 가져오기를 지원하며, *.blend1 Blender 파일은 커밋할 필요가 없습니다
| 패턴 | 제외 대상 |
|---|---|
*.blend1 |
Unity는 기본적으로 Blender 에셋 가져오기를 지원하며, *.blend1 Blender 파일은 커밋할 필요가 없습니다 |
*.blend1.meta |
Unity는 기본적으로 Blender 에셋 가져오기를 지원하며, *.blend1 Blender 파일은 커밋할 필요가 없습니다 |
매우 민감한 데이터가 포함될 수도 있습니다
| 패턴 | 제외 대상 |
|---|---|
/[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 |
Visual Scripting 자동 생성 파일
| 패턴 | 제외 대상 |
|---|---|
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Flow/UnitOptions.db |
Visual Scripting 자동 생성 파일 |
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Flow/UnitOptions.db.meta |
Visual Scripting 자동 생성 파일 |
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Core/Property Providers |
Visual Scripting 자동 생성 파일 |
/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Core/Property Providers.meta |
Visual Scripting 자동 생성 파일 |
플레이 모드 테스트가 자동 생성한 씬
| 패턴 | 제외 대상 |
|---|---|
/[Aa]ssets/[Ii]nit[Tt]est[Ss]cene*.unity* |
플레이 모드 테스트가 자동 생성한 씬 |
UI Toolkit 자동 생성 파일
| 패턴 | 제외 대상 |
|---|---|
/UIElementsSchema/ |
UI Toolkit 자동 생성 파일 |
Assets 폴더의 자동 생성 캐시
| 패턴 | 제외 대상 |
|---|---|
/[Aa]ssets/[Ss]ceneDependencyCache* |
Assets 폴더의 자동 생성 캐시 |
이 Unity용 .gitignore 사용 방법
- 위의 Unity 규칙을 복사하거나 파일을 바로 다운로드하세요.
- Git 저장소 루트에 .gitignore라는 파일을 만들고 규칙을 붙여 넣으세요.
- 이미 추적 중인 파일이 있다면 git rm -r --cached . 명령을 실행한 다음 다시 커밋하세요. Git은 추적하지 않는 파일에만 제외 규칙을 적용합니다.
- 팀원 모두가 같은 규칙을 사용하도록 .gitignore를 커밋하세요.