© mengzhishanghun · 原创文章
首发于 博客园 · 禁止未经授权转载
前言
UE项目打包时，Config 目录下的所有 .ini 配置文件默认都会被包含进去。但实际开发中，有些配置文件你并不希望出现在发布版本中：
- 调试配置：开发阶段的调试开关、性能分析参数
- 开发环境配置：测试服务器地址、开发密钥
- 插件私有配置：某些插件的内部配置，不需要随包发布
- 多环境部署：测试环境和生产环境需要不同的配置集
UE 提供了 DefaultGame.ini 中的 [Staging] 区段来控制配置文件的打包行为，但手动编辑这个文件既繁琐又容易出错——你需要记住正确的格式（+AllowedConfigFiles / +DisallowedConfigFiles），还要带上项目名前缀。
SimpleConfigExclude 插件将这个过程可视化，在编辑器设置面板中直接操作。
一、核心功能
1.1 三态配置选择器
插件为每个配置文件提供三种状态：
| 状态 | 含义 | 效果 |
|---|---|---|
| Default | 默认 | 跟随 UE 默认行为 |
| Allowed | 强制包含 | 确保该配置文件一定会被打包 |
| Disallowed | 强制排除 | 确保该配置文件不会被打包 |
在项目设置面板中，每个 .ini 文件旁边都有一个三态切换控件（SSegmentedControl），点击即可切换。
1.2 自动扫描与应用
插件的工作流完全自动化：
- 编辑器启动时自动扫描
Config目录下所有.ini文件 - 读取现有规则从
DefaultGame.ini的[Staging]区段 - 生成配置列表展示在设置面板中
- 修改即生效切换状态后立即写入
DefaultGame.ini
你不需要手动编辑任何 .ini 文件，插件会自动处理格式、项目名前缀、源控制检出等所有细节。
1.3 复制排除文件
打包后，被排除的配置文件不会出现在打包目录中。但有些场景下你可能需要在打包后手动补充某些配置文件（比如部署到不同环境时）。
插件提供了一键复制功能：
- 配置目标目录（默认
/Windows） - 点击
Copy按钮 - 所有标记为
Disallowed的配置文件会被复制到目标目录 - 可选在复制前清理目标 Config 文件夹
这对于多环境部署非常实用——打包一个干净的基础版本，然后按需补充不同环境的配置文件。
1.4 安全设计
- 隐藏插件自身配置：默认隐藏
DefaultSimpleConfigExclude.ini，防止误操作导致插件配置丢失 - 源控制集成：修改
DefaultGame.ini前自动检出（支持 Perforce/Git） - 只读保护：未使用源控制时自动移除只读属性
二、实现原理
2.1 UE 的 Staging 机制
UE 打包时通过 DefaultGame.ini 中的 [Staging] 区段控制配置文件的包含与排除：
[Staging]
+AllowedConfigFiles=MyProject/Config/DefaultInput.ini
+DisallowedConfigFiles=MyProject/Config/DefaultDebug.ini
插件所做的就是自动管理这个区段，将你的可视化操作转换为正确的 ini 格式。
2.2 扫描与规则同步
void USimpleConfigExcludeSettings::ScanAndUpdateConfigFiles()
{// 递归扫描 Config 目录下所有 .ini 文件IFileManager::Get().FindFilesRecursive(FoundIniFiles, *ConfigDir, TEXT("*.ini"), true, false);// 直接从文件读取 [Staging] section（不依赖 GConfig 缓存）// 解析 AllowedConfigFiles 和 DisallowedConfigFiles// 重建规则列表，匹配现有配置状态
}
关键点：插件直接读取文件内容而非依赖 GConfig 缓存，确保读取的始终是最新状态。
2.3 规则应用
void USimpleConfigExcludeSettings::ApplyExcludeRules()
{// 移除旧的 [Staging] 区段// 根据当前规则列表重新生成// 写回 DefaultGame.ini// 重新加载配置以保持状态一致GConfig->UnloadFile(IniFilePath);GConfig->LoadFile(IniFilePath);
}
每次状态变更后，插件会完整重写 [Staging] 区段并重新加载配置，确保编辑器内状态和文件内容完全一致。
三、快速上手
步骤1：安装插件
将插件文件夹复制到项目的 Plugins 目录，重启编辑器。
步骤2：打开设置面板
路径：Edit > Project Settings > Plugins > Simple Config Exclude
面板分为三个区域：
- Settings：通用设置（是否隐藏插件配置、复制前是否清理目标目录）
- Copy：复制排除文件到目标目录
- Config Exclude Rules：配置文件列表和三态选择器
步骤3：配置规则
- 找到你要排除的配置文件
- 点击
Disallowed即可排除 - 需要强制包含的点击
Allowed - 修改即时生效，无需额外保存
步骤4：打包验证
正常打包项目，检查打包目录中的 Config 文件夹，确认排除的文件不存在。
四、使用场景
场景1：排除调试配置
项目中有 DefaultDebug.ini 存储调试参数，生产环境不需要：
DefaultDebug.ini → Disallowed
场景2：多环境部署
1. 将测试环境配置标记为 Disallowed
2. 打包得到干净的基础版本
3. 用 Copy 功能将排除的配置复制到测试环境部署目录
4. 生产环境使用打包后的默认配置
场景3：保护敏感配置
DefaultEncryption.ini → Disallowed // 密钥配置不随包发布
DefaultServer.ini → Disallowed // 服务器配置通过运维单独部署
五、插件获取
适用版本： Unreal Engine 5.2+
获取方式： 在 Fab 商店搜索 SimpleConfigExclude 即可找到
有任何问题欢迎在评论区交流。
总结
SimpleConfigExclude 将 UE 打包时的配置文件管理从手动编辑 ini 文件变为可视化操作：
- 三态选择器：Default / Allowed / Disallowed，点击即切换
- 自动扫描：编辑器启动时自动发现所有配置文件
- 即时生效：修改后立即写入 DefaultGame.ini
- 一键复制：将排除的文件复制到指定目录，支持多环境部署
- 安全设计：隐藏插件自身配置、自动检出源控制文件
再也不需要手动编辑 [Staging] 区段了。
感谢阅读，欢迎点赞、关注、收藏，有问题可在评论区交流。
如果本文对你有帮助，点击这里捐赠支持作者。