Visual Studio 2019打开UE5项目报错E0070 不允许使用不完整类型

问题表现 #

• 操作流程：Unreal Engine 5内新建项目后，未修改任何项目代码、配置，仅通过Visual Studio 2019浏览检索项目文件，触发构建时抛出系列编译错误
• 核心报错：错误码E0070，提示信息为incomplete type is not allowed（不允许使用不完整类型）
• 报错特征：错误指向多为引擎自带头文件内容，和用户自定义代码无关

问题根因 #

这类问题不属于代码逻辑错误，均为环境适配、缓存或配置异常导致：

• VS2019版本不满足UE5运行要求：UE5最低要求VS2019 16.11及以上正式版，低版本VS缺少C++标准特性支持，无法正确识别引擎头文件内的类型声明
• 项目文件、编译缓存损坏：直接双击sln文件打开项目时，VS无法获取UE传入的包含目录、预编译宏等编译参数，加上首次加载时IntelliSense缓存未生成完成，会误将前置声明的类型判定为不完整类型
• 预编译头、反射数据未同步：新建项目首次打开前未生成对应反射代码，IntelliSense和编译链路找不到类型的完整定义

修复步骤 #

按顺序操作，每步完成后可尝试一次构建，无需全部执行：

1. 校准VS2019安装配置
   打开Visual Studio Installer，将VS2019更新至16.11.x最新正式版，在「使用C++的游戏开发」工作负载下，确认勾选以下组件：
   • Unreal Engine 安装程序
   • 对应系统版本的Windows 10/11 SDK
   • MSVC v142（VS2019）x64/x86生成工具
2. 清理缓存重新生成项目文件
   • 关闭所有VS窗口，回到UE编辑器，执行「文件-刷新Visual Studio项目」，等待操作完成
   • 进入项目根目录，删除.vs隐藏文件夹、Binaries文件夹、Intermediate文件夹
   • 右键项目.uproject文件，选择「Generate Visual Studio project files」，等待生成完成后，不要直接双击sln文件，通过UE编辑器工具栏的「打开Visual Studio」按钮拉起IDE
3. 修复IntelliSense误报
   • VS启动后等待底部「正在解析文件」进度条完全走完，再触发构建
   • 若仍报E0070错误，执行「项目-重扫描解决方案-重扫描所有文件」，等待扫描完成后重试
   • 若误报持续存在，可进入VS「选项-文本编辑器-C/C++-高级」，将「禁用IntelliSense」设置为True，UE配套的VA/RiderLink插件会替代原生IntelliSense提供代码提示，不会再触发这类假错
4. 高版本UE兼容处理
   若使用UE5.2及以上版本，官方已将VS2022作为首选适配IDE，直接安装VS2022对应游戏开发组件后重新生成项目文件，即可彻底规避这类版本适配问题

注意：不要通过修改引擎内置头文件的方式尝试消除错误，这类操作会破坏引擎编译链路，触发更多不可预期的编译问题。

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