github/gitignore · UnrealEngine.gitignore
Unreal Engine .gitignore 템플릿 해설
UnrealEngine.gitignore가 Binaries·Intermediate·Saved·DerivedDataCache와 생성된 솔루션 파일을 무시하는 이유, Build 폴더의 부정 규칙 구조를 설명합니다.
UnrealEngine.gitignore는 언리얼 엔진 C++ 프로젝트를 위한 템플릿이다. 엔진이 컴파일·쿠킹·셰이더 캐시를 위해 만드는 대용량 폴더와, 에디터가 다시 만들어 주는 IDE 프로젝트 파일을 제외한다.
Build/ 폴더를 다루는 다섯 줄은 gitignore 우선순위를 보여 주는 좋은 예다. 폴더 내용은 모두 제외하되 플랫폼별 하위 폴더는 되살리고, 그 안에서 아이콘과 PakBlacklist 파일만 다시 포함한다.
규칙별 해설
| 패턴 | 무엇을, 왜 무시하나 |
|---|---|
Binaries/*Intermediate/*Saved/*DerivedDataCache/* | 엔진 생성 폴더컴파일된 모듈, 중간 빌드 파일, 로그·자동 저장·설정 캐시, 셰이더·에셋 파생 데이터다. 모두 에디터나 빌드가 다시 만든다. |
Plugins/**/Binaries/*Plugins/**/Intermediate/* | 플러그인 빌드 결과프로젝트 플러그인도 각자 Binaries·Intermediate를 만든다. **로 어느 깊이의 플러그인이든 일치시킨다. |
Build/*!Build/*/Build/*/**!Build/*/PakBlacklist*.txt!Build/**/*.ico | Build 폴더 예외 구조Build/*로 내용을 제외하고 !Build/*/로 하위 디렉터리를 되살린다. 디렉터리가 살아 있어야 Build/*/**로 다시 제외한 뒤 PakBlacklist와 아이콘 파일만 !로 포함할 수 있다. 상위 디렉터리가 제외되면 하위 파일을 되살릴 수 없다는 규칙을 피해 가는 방법이다. |
*.sln*.suo*.xcodeproj*.xcworkspace.vs/.vsconfig | 생성된 IDE 프로젝트.uproject에서 'Generate Project Files'로 언제든 다시 만드는 Visual Studio·Xcode 파일이다. |
*.obj*.o*.pch*.dll*.lib*.exe*.app*.ipa | 컴파일 산출물C++ 컴파일·링크 결과와 패키징 결과다. |
*_BuiltData.uasset | 빌드된 라이팅 데이터라이트 빌드로 만들어지는 맵별 데이터다. 크고 자주 바뀌며 다시 빌드할 수 있다. |
SourceArt/**/*.pngSourceArt/**/*.tga | 원본 아트임포트 전 원본 텍스처 폴더를 저장소에서 빼려는 규칙이다. 원본을 버전 관리하려면 지우고 Git LFS를 쓴다. |
실무에서 주의할 점
.uasset·.umap같은 바이너리 에셋은 Git LFS로 추적하는 것이 사실상 필수다.Config/,Content/,Source/,.uproject는 커밋 대상이다.Saved/Config에 있는 설정은 개인 설정이므로 제외된 상태가 맞다.Build/구조를 바꾸기 전에 패턴 테스터에Build/Windows/Application.ico같은 경로를 넣어 결과를 확인한다.
원본 템플릿
UnrealEngine.gitignore
# Visual Studio 2015 user specific files.vs/# Compiled Object files*.slo*.lo*.o*.obj# Precompiled Headers*.gch*.pch# Compiled Dynamic libraries*.so*.dylib*.dll# Fortran module files*.mod# Compiled Static libraries*.lai*.la*.a*.lib# Executables*.exe*.out*.app*.ipa# These project files can be generated by the engine*.xcodeproj*.xcworkspace*.sln*.suo*.opensdf*.sdf*.VC.db*.VC.opendb.vsconfig# Precompiled AssetsSourceArt/**/*.pngSourceArt/**/*.tga# Binary FilesBinaries/*Plugins/**/Binaries/*# BuildsBuild/*# Whitelist PakBlacklist-<BuildConfiguration>.txt files!Build/*/Build/*/**!Build/*/PakBlacklist*.txt# Don't ignore icon files in Build!Build/**/*.ico# Built data for maps*_BuiltData.uasset# Configuration files generated by the EditorSaved/*# Compiled source files for the engine to useIntermediate/*Plugins/**/Intermediate/*# Cache files for the editor to useDerivedDataCache/*
템플릿 출처: github/gitignore/UnrealEngine.gitignore @356fd7b (2026-09-11) · CC0-1.0