CMake技术疑问：何时需在CMakeLists.txt中使用include_directories？

这个问题问得很到位！你猜的没错，target_link_libraries在这里确实起了关键作用，但背后其实是CMake的**导入目标（Imported Targets）**机制在帮忙。下面我一步步拆解：

核心原因：导入目标自动传递依赖信息 #

现代版本的CURL库（以及很多流行的第三方库）在被find_package(CURL REQUIRED)找到后，会提供一个像CURL::libcurl这样的导入目标。这个目标不仅包含了链接所需的库文件路径，还封装了对应的头文件包含路径、编译选项等所有依赖信息。

当你在target_link_libraries里关联这个导入目标时：

target_link_libraries(your_executable PRIVATE CURL::libcurl)

CMake会自动把CURL::libcurl关联的头文件路径添加到你的可执行目标的包含路径中，完全不需要手动写include_directories。这就是你的项目移除该指令后还能正常构建的原因。

怎么判断一个库是否需要include_directories？ #

可以通过以下几个方法来判断：

1. 检查库是否提供CMake导入目标 #

• 先看你用find_package获取库时的文档或输出：比如CURL的CMake配置文件会明确说明提供CURL::libcurl目标。你可以在CMakeLists里加一行调试输出验证：

  find_package(CURL REQUIRED)
  message(STATUS "CURL导入目标是否存在：$<TARGET_EXISTS:CURL::libcurl>")
  

  如果输出是TRUE，那说明可以直接用导入目标，不需要include_directories。
• 如果库只提供传统的变量（比如旧版本CURL的CURL_INCLUDE_DIRS和CURL_LIBRARIES），那你就需要手动把包含路径添加到目标中（推荐用target_include_directories而非全局的include_directories）：

  target_include_directories(your_executable PRIVATE ${CURL_INCLUDE_DIRS})
  target_link_libraries(your_executable PRIVATE ${CURL_LIBRARIES})
  

2. 检查头文件的查找路径 #

• 看你代码里的头文件引用：比如#include <curl/curl.h>。如果这个头文件位于系统默认的包含路径（比如/usr/include或/usr/local/include），那即使不用include_directories，编译器也能自动找到。但如果是你自己编译的库放在非标准路径（比如~/my_lib/include），那无论如何都需要指定包含路径——不过导入目标会帮你自动处理这一点。
• 可以通过CMake的CMAKE_CXX_FLAGS添加-v选项，查看编译器实际的头文件搜索路径：

  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -v")
  

  构建时的输出里会列出所有搜索路径，你可以确认库的头文件是否在其中。

3. 遵循现代CMake的最佳实践 #

• 尽量避免使用全局的include_directories，而是用目标级别的target_include_directories，这样只会影响特定的目标，不会污染整个项目的全局设置。
• 优先使用导入目标（比如CURL::libcurl）而非直接链接库文件，因为导入目标会自动处理所有依赖细节，减少手动配置的出错概率。

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