使用Unreal Engine Development Editor模式编译时出现构建错误求助

注：图中“확인할 수 없는 외부 기호”对应英文的unresolved external reference（未解析外部引用）

问题原因 #

Debug Game Editor和Development Editor模式的编译校验逻辑存在差异：

• Debug模式会启用延迟绑定、宽松的符号检查，部分未正确链接的引用会被暂时掩盖；而Development模式是优化编译，对符号引用的校验更严格，还会启用链接时优化等特性，会暴露Debug模式下被忽略的问题。
• 具体可能的诱因：
  • 第三方插件/静态库仅提供了Debug版本的编译文件，缺少Development模式对应的库
  • 项目.Build.cs中依赖模块配置不全，仅在Debug模式下自动补全了依赖，Development模式未正确声明
  • 代码中存在#if DEVELOPMENT_BUILD这类条件编译块，其中引用了未配置链接的外部符号
  • 旧编译缓存干扰，Development模式下未正确更新依赖关系

解决方案 #

• 检查模块依赖配置：打开项目的.Build.cs文件，确认所有用到的模块都已添加到PublicDependencyModuleNames或PrivateDependencyModuleNames列表中，尤其是那些仅在Development模式下触发引用的模块。
• 验证第三方库的多配置支持：如果使用了第三方插件或静态库，确认它们提供了Development模式对应的编译版本（通常文件名带Development后缀），并在.Build.cs中通过Configuration分支指定对应配置的库路径。
• 彻底清理编译缓存：手动删除项目目录下的Binaries、Intermediate、Saved文件夹，再重新生成项目文件并编译，避免旧缓存导致的依赖异常。
• 排查条件编译代码：搜索项目中所有条件编译指令（如#if DEVELOPMENT_BUILD、#if WITH_EDITOR），确认其中引用的外部符号都有对应的链接支持。
• 查看详细链接日志：在IDE中开启详细链接日志（Visual Studio：项目属性→链接器→常规→启用详细日志；Rider：编译设置中开启链接器详细输出），定位具体未解析的符号名称，针对性修复对应的依赖或代码。

内容的提问来源于stack exchange，提问作者Shark_Bladder