CMake中add_library源码匹配疑问:HelloWorld目标如何找到对应文件
核心结论
CMake并不是自动搜索以HelloWorld开头的任意扩展名文件,而是依赖内置的隐式源码扩展名匹配规则实现的。
具体逻辑拆解
- 隐式扩展名匹配机制:在
add_library或add_executable指令中,当你只传入不带扩展名的文件名前缀时,CMake会自动在当前源目录下查找它默认识别的源码扩展名文件。对于C++项目,CMake默认支持的扩展名包括.cc、.cpp、.cxx、.C等;头文件(如.hh、.hpp、.h)会被自动关联到目标,但不会作为编译单元参与编译。 - 你的场景适配:目录下的
HelloWorld.cc正好匹配前缀HelloWorld,CMake会自动将该文件作为编译源码加入HelloWorld共享库目标。而HelloWorld.hh会被识别为该目标的关联头文件,只要代码中include路径配置正确,编译时就能被正确引用。 - 构建成功的原因:CMake 3.22.1完全支持这种便捷写法,在解析
add_library指令时,会自动扫描当前目录,匹配前缀+默认扩展名的文件组合,将找到的.cc文件纳入编译流程。
额外提示
这种写法虽然便捷,但如果目录下存在多个同前缀不同扩展名的源码文件(比如同时有HelloWorld.cc和HelloWorld.cpp),CMake会将它们全部加入目标。如果需要精确控制编译文件,建议显式指定完整文件名(如HelloWorld.cc)。
内容的提问来源于stack exchange,提问作者PhiloRobotist
相关产品推荐
相关产品推荐

