CMake中find_package(MPI)与FindMPI的差异及相关技术疑问

我来帮你理清CMake里find_package(MPI)和FindMPI这两者的关系、差异以及你关心的几个核心问题：

• 本质角色不同：find_package(MPI)是CMake提供的内置命令，用来启动整个包查找的流程；而FindMPI是CMake官方维护的查找模块（对应内置的FindMPI.cmake文件），是find_package命令在「Module模式」下会调用的具体实现载体。
• 查找逻辑的优先级差异：执行find_package(MPI)时，CMake会优先尝试「Config模式」——也就是寻找MPI发行版自带的MPIConfig.cmake或mpi-config.cmake配置文件；只有当Config模式失败时，才会降级到「Module模式」，去调用FindMPI.cmake的通用查找逻辑。但如果直接写include(FindMPI)，会跳过Config模式的检查，直接执行这个模块里的查找代码。
• 配置规范性的细微区别：如果通过Config模式找到MPI，通常会得到更贴合该MPI发行版自身规范的变量和导入目标；而FindMPI是通用实现，会适配各种不同的MPI发行版（比如OpenMPI、MPICH等），兼容性更强但可能少一些发行版特有的配置细节。不过对于绝大多数常规项目来说，二者导出的核心变量（比如MPI_FOUND、MPI_C_COMPILER）和现代CMake导入目标（MPI::MPI_C、MPI::MPI_CXX）是完全一致的。

从CMake 3.0直到目前的最新版本（比如CMake 3.28+），这种「功能上的互换性」是依然保持的。不过这里要明确：所谓的“互换”是指当find_package(MPI)触发Module模式时，本质就是在调用FindMPI的逻辑；但反过来，直接include(FindMPI)和find_package(MPI)并不完全等价（前者跳过了Config模式的尝试）。CMake官方一直维护着FindMPI模块的向后兼容性，只要你的项目没有依赖Config模式特有的特性，两种方式触发的MPI查找核心逻辑是一致的。

FindMPI模块本身不直接接受REQUIRED这类参数，但你可以手动实现和find_package(MPI REQUIRED)完全等价的效果：

1. 先通过include(FindMPI)执行查找逻辑
2. 检查模块设置的MPI_FOUND变量，找不到就终止配置流程，示例代码如下：

include(FindMPI)
if(NOT MPI_FOUND)
    message(FATAL_ERROR "MPI is required but could not be found!")
endif()

而find_package(MPI REQUIRED)的底层逻辑，当走Module模式时，其实也是基于FindMPI设置的MPI_FOUND变量来自动完成这个检查的。

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