github/gitignore · UnrealEngine.gitignore
Unreal Engine .gitignore テンプレート解説
UnrealEngine.gitignore が Binaries・Intermediate・Saved・DerivedDataCache と生成されたソリューションファイルを無視する理由、Build フォルダーの否定ルールの構造を説明します。
UnrealEngine.gitignore は Unreal Engine の C++ プロジェクト向けのテンプレートである。エンジンがコンパイル・クッキング・シェーダーキャッシュのために作る大容量フォルダーと、エディターが作り直してくれる IDE プロジェクトファイルを除外する。
Build/ フォルダーを扱う 5 行は、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