Unreal Engine 的 .gitignore

适用于 Unreal Engine 的 42 条忽略规则,可直接复制到您的仓库。

游戏引擎由Epic Games开发

Unreal Engine 的完整 .gitignore

# 由 LFGitignore - https://lfgitignore.com 生成
# 创建:2026-10-31 21:54:53 UTC
# 技术:Unreal Engine

### Unreal Engine ###
.vs/
*.slo
*.lo
# 目标文件
*.o
# 目标文件
*.obj
*.gch
*.pch
# iOS 应用程序存档
*.ipa
# 共享对象
*.so
# macOS动态库
*.dylib
# 动态链接库
*.dll
*.mod
*.lai
*.la
# 静态库
*.a
# 库文件
*.lib
# Windows 可执行文件
*.exe
# 编译器输出
*.out
*.xcodeproj
# 应用程序包
*.app
*.xcworkspace
# Visual Studio溶液
*.sln
# 解决方案用户选项
*.suo
*.opensdf
*.sdf
*.VC.db
*.VC.opendb
.vsconfig
SourceArt/**/*.png
SourceArt/**/*.tga
Binaries/*
Plugins/**/Binaries/*
Build/*
!Build/*/
Build/*/**
!Build/*/PakBlacklist*.txt
!Build/**/*.ico
*_BuiltData.uasset
Saved/*
Intermediate/*
Plugins/**/Intermediate/*
DerivedDataCache/*

这些 Unreal Engine 规则实际上忽略了什么

以下列出了每个忽略模式及其加入 .gitignore 的原因。

Visual Studio 2015 用户特定文件

模式 忽略的内容
.vs/ Visual Studio 2015 用户特定文件

编译后的目标文件

模式 忽略的内容
*.slo 编译后的目标文件
*.lo 编译后的目标文件
*.o 目标文件
*.obj 目标文件

预编译头文件

模式 忽略的内容
*.gch 预编译头文件
*.pch 预编译头文件

可执行文件

模式 忽略的内容
*.ipa iOS 应用程序存档
*.exe Windows 可执行文件
*.out 编译器输出
*.app 应用程序包

编译的动态库

模式 忽略的内容
*.so 共享对象
*.dylib macOS动态库
*.dll 动态链接库

Fortran 模块文件

模式 忽略的内容
*.mod Fortran 模块文件

编译静态库

模式 忽略的内容
*.lai 编译静态库
*.la 编译静态库
*.a 静态库
*.lib 库文件

这些项目文件可以由引擎生成

模式 忽略的内容
*.xcodeproj 这些项目文件可以由引擎生成
*.xcworkspace 这些项目文件可以由引擎生成
*.sln Visual Studio溶液
*.suo 解决方案用户选项
*.opensdf 这些项目文件可以由引擎生成
*.sdf 这些项目文件可以由引擎生成
*.VC.db 这些项目文件可以由引擎生成
*.VC.opendb 这些项目文件可以由引擎生成
.vsconfig 这些项目文件可以由引擎生成

预编译资源

模式 忽略的内容
SourceArt/**/*.png 预编译资源
SourceArt/**/*.tga 预编译资源

二进制文件

模式 忽略的内容
Binaries/* 二进制文件
Plugins/**/Binaries/* 二进制文件

构建

模式 忽略的内容
Build/* 构建

白名单 PakBlacklist-<BuildConfiguration>.txt 文件

模式 忽略的内容
!Build/*/ 白名单 PakBlacklist-<BuildConfiguration>.txt 文件
Build/*/** 白名单 PakBlacklist-<BuildConfiguration>.txt 文件
!Build/*/PakBlacklist*.txt 白名单 PakBlacklist-<BuildConfiguration>.txt 文件

不要忽略 Build 目录中的图标文件

模式 忽略的内容
!Build/**/*.ico 不要忽略 Build 目录中的图标文件

为地图构建数据

模式 忽略的内容
*_BuiltData.uasset 为地图构建数据

编辑器生成的配置文件

模式 忽略的内容
Saved/* 编辑器生成的配置文件

编译好的源文件供引擎使用

模式 忽略的内容
Intermediate/* 编译好的源文件供引擎使用
Plugins/**/Intermediate/* 编译好的源文件供引擎使用

缓存文件供编辑器使用

模式 忽略的内容
DerivedDataCache/* 缓存文件供编辑器使用

如何将此 .gitignore 用于 Unreal Engine

  1. 复制上面的Unreal Engine规则,或者直接下载文件。
  2. 在 Git 仓库根目录创建名为 .gitignore 的文件,并将规则粘贴进去。
  3. 如果其中一些文件已被跟踪,请运行 git rm -r --cached . 然后再次提交 - Git 仅将忽略规则应用于未跟踪的文件。
  4. 提交 .gitignore 以便团队中的每个人都共享相同的规则。

其他 游戏引擎 .gitignore 模板

查看每个 游戏引擎 模板