UE4.26重编译Dialogue System插件遇头文件规范与依赖缺失报错求助

UHT解析阶段批量提示「同名头文件需为首个引用项」修复 #

该报错是Unreal Build Tool的强制校验规则，无绕过方案，按以下步骤处理：

• 批量排查所有触发报错的插件cpp文件，检查文件开头前10行内容：
  • 若开头存在版权注释块、自定义调试宏、第三方库include等非同名头文件内容，全部移动到「与cpp同名的头文件include语句」之后
  • 错误代码顺序示例：

    // 顺序不满足UHT要求
    #define DEBUG_DIALOGUE 1
    #include "DialogueSystemBPLibrary.h"
    

  • 修正后顺序：

    // 必须将同名头文件作为cpp首个有效include项
    #include "DialogueSystemBPLibrary.h"
    #define DEBUG_DIALOGUE 1
    

• 注意：哪怕cpp开头放置模块初始化宏，只要不是对应同名头文件的include，都会触发该报错，必须严格遵守编码规则。

C1083错误提示无法打开Widget.h修复 #

该报错本质是插件构建规则未声明对应模块依赖，导致编译器无法定位UMG模块的头文件路径，按以下步骤处理：

• 打开插件源码目录下的DialogueSystem.Build.cs，在依赖模块数组中补充缺失项：
  • 找到PublicDependencyModuleNames、PrivateDependencyModuleNames的定义位置，将"UMG"加入依赖列表（Widget.h为UMG模块提供的公开接口），同时确认已补充BT任务所需的"GameplayTasks"依赖
  • 正确依赖写法参考：

    PublicDependencyModuleNames.AddRange(new string[] {
        "Core", "CoreUObject", "Engine", "InputCore",
        "GameplayTasks", "UMG"
    });
    

• 修正触发报错的头文件引用路径：打开BTTask_ShowPhrases.h，将第7行的#include "Widget.h"修改为完整路径#include "Components/Widget.h"，解决短路径搜索失败问题。

编译前必做的缓存清理步骤 #

残留的旧构建规则缓存会导致修改失效，按顺序执行：

• 关闭所有UnrealEditor.exe、MSBuild.exe、Visual Studio 2019进程
• 删除项目主目录下的Binaries、Intermediate文件夹，同时删除插件目录下对应的Binaries、Intermediate文件夹
• 右键项目的.uproject文件，选择「Generate Visual Studio project files」重新生成工程构建规则
• 用匹配的VS2019 14.27工具链打开解决方案，重新编译MyProjectEditor目标即可。

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