Visual Studio下CMake子目录引入Assimp的编译异常排查

两个报错本质上都来自Assimp的CMake脚本对「自身仓库作为顶层源根目录」的场景做了硬编码适配，一旦通过add_subdirectory()嵌入其他项目，原有的路径逻辑就会错位：

• 关于draco/draco_features.h找不到的问题：这个头文件不是Assimp仓库自带的静态文件，是CMake配置阶段为draco库动态生成的功能配置头。Assimp脚本原本的逻辑是把这个生成文件的输出路径，直接相对于Assimp自身的二进制目录传递给glTF2模块的include搜索列表；但当Assimp作为子目录嵌入你的项目时，相对路径的计算基准从「Assimp独立构建的根目录」变成了你项目的全局构建目录，原有的相对路径没有跟着调整，就会导致编译glTF2模块时搜索不到这个动态生成的头文件。
• 关于assimp-vc142-mtd.lib找不到的问题：这个报错只在VS这类多配置生成器下出现。Assimp脚本给assimp_cmd、单元测试这类附属目标写的库链接路径，用了硬编码的lib/${CMAKE_BUILD_TYPE}相对路径，没有适配多配置生成器下「构建输出路径随当前激活的Debug/Release配置自动变化」的逻辑。当独立构建Assimp时，这个硬编码路径刚好和实际输出位置匹配；但嵌入项目后，assimp库的实际输出位置在全局构建目录的对应配置子文件夹里，硬编码路径指向了不存在的位置，就会报找不到lib的链接错误。

按照以下顺序修改你项目根目录的CMakeLists.txt即可，全程不需要修改Assimp源码：

• 第一步，在调用add_subdirectory(vendor/assimp)之前，强制锁定Assimp的构建配置，关闭不必要的附属目标，减少路径错位的可能：

# 关闭非必要构建目标，避免多余的链接报错
set(ASSIMP_BUILD_TESTS OFF CACHE BOOL "禁用Assimp单元测试构建" FORCE)
set(ASSIMP_BUILD_ASSIMP_TOOLS OFF CACHE BOOL "禁用Assimp命令行工具构建" FORCE)
set(ASSIMP_INSTALL OFF CACHE BOOL "禁用Assimp的安装规则" FORCE)
# 保持draco功能开启，不损失模型导入能力
set(ASSIMP_BUILD_DRACO ON CACHE BOOL "启用Draco压缩模型支持" FORCE)
# 强制构建静态版本的Assimp，避免动态库命名带来的路径匹配问题
set(BUILD_SHARED_LIBS OFF CACHE BOOL "以静态库形式构建Assimp" FORCE)

• 第二步，引入Assimp子目录：

add_subdirectory(vendor/assimp)

• 第三步，手动补全draco动态生成头文件的搜索路径，解决头文件找不到的问题：

# 定位draco动态生成头文件的绝对路径，不依赖原脚本的相对路径逻辑
# 此时assimp_BINARY_DIR已经被add_subdirectory正确赋值，指向Assimp的构建输出目录
set(ASSIMP_DRACO_GEN_PATH "${assimp_BINARY_DIR}/contrib/draco")
# 将该目录加入全局头文件搜索路径，让glTF2模块可以正常找到draco相关头文件
include_directories(${ASSIMP_DRACO_GEN_PATH})

• 第四步，通过CMake的目标导出机制链接Assimp，不要手动拼接库文件路径：

# 给你的应用程序目标链接Assimp，CMake会自动传递所有正确的include、库文件路径
target_link_libraries(你的应用目标名 PRIVATE assimp::assimp)

• 验证流程：清空原有构建缓存目录后重新执行CMake配置、VS工程生成、Debug编译流程，即可正常启用带draco支持的Assimp功能，不会出现头文件缺失、库文件定位失败的报错。

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