Linux下cmake-conan集成大小写敏感致Boost配置文件查找失败怎么解决？

核心原因 #

Windows文件系统不区分大小写，所以BoostConfig.cmake能被find_package(boost)正常识别；但OracleLinux 9是大小写敏感的，CMake默认查找boostConfig.cmake或boost-config.cmake，和实际存在的BoostConfig.cmake不匹配，导致查找失败。

以下是几种可行的解决方法：

方案1：修正CMakeLists.txt中的查找逻辑 #

直接调整find_package的调用参数，匹配实际存在的配置文件名：

# 改用大写的Boost进行查找，对应实际的BoostConfig.cmake
find_package(Boost REQUIRED CONFIG)

注意同步修改代码中引用的变量名，比如将${boost_INCLUDE_DIRS}改为${Boost_INCLUDE_DIRS}，${boost_LIBRARIES}改为${Boost_LIBRARIES}。

如果需要指定查找路径，也可以明确指向配置文件所在目录：

find_package(Boost REQUIRED CONFIG PATHS ${CMAKE_BINARY_DIR}/conan)

方案2：通过Conan配置生成小写的配置文件 #

修改Conan配置，让其生成CMake预期的小写配置文件名：

• 若使用conanfile.txt，添加配置项：

[requires]
boost/1.82.0  # 替换为你使用的Boost版本

[generators]
CMakeDeps

[conf]
tools.cmake.cmaketoolchain:file_name=boost-config.cmake

• 若使用conanfile.py，在类中添加配置：

from conan import ConanFile

class MyProjectConan(ConanFile):
    requires = "boost/1.82.0"
    generators = "CMakeDeps"

    def configure(self):
        self.conf.define("tools.cmake.cmaketoolchain:file_name", "boost-config.cmake")

修改后重新执行conan install，Conan会生成boost-config.cmake，CMake即可正常识别。

方案3：创建符号链接临时适配 #

如果需要快速验证，可在构建目录中创建符号链接，让小写文件名指向实际的大写配置文件：

cd <你的构建目录路径>
ln -sf BoostConfig.cmake boostConfig.cmake
ln -sf BoostConfig.cmake boost-config.cmake

此方法仅适合临时测试，每次重新执行conan install后需要重新创建链接。

方案4：更新cmake-conan到最新版本 #

旧版本的cmake-conan可能存在配置文件名大小写处理的bug，更新到最新版本可解决此类问题：

pip install --upgrade cmake-conan

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