Linux/CMake技术问询：如何让链接器显示库文件查找路径？

针对头文件（.h）或共享库（.so）找不到导致编译失败的问题，可通过以下参数让编译器/链接器输出完整的查找路径列表，且明确显示路径末尾斜杠：

一、头文件（.h）查找路径输出 #

头文件查找属于预处理阶段，可通过以下参数查看详细路径：

• -H 参数（GCC/Clang）：
  直接输出每个头文件的查找结果，用缩进表示嵌套依赖，找不到的文件会用 ? 标记，同时列出所有搜索路径。命令示例：

  gcc -H -c your_source.c
  

  输出示例（含路径末尾斜杠）：

  . /usr/include/stdio.h
  ? mymodule/mylibrary.h
  #include "..." search starts here:
  #include <...> search starts here:
   ./
   /usr/local/include/
   /usr/include/x86_64-linux-gnu/
   /usr/include/
  End of search list.
  

• -v 参数（GCC/Clang）：
  输出完整的预处理、编译流程，其中包含头文件搜索路径块，路径末尾斜杠清晰可见：

  gcc -v -c your_source.c
  

二、共享库（.so）查找路径输出 #

共享库查找属于链接阶段，可通过以下参数获取详细路径：

• -Wl,--verbose 参数（GCC/Clang）：
  传递 --verbose 参数给链接器，输出链接过程中所有的库搜索路径，路径末尾斜杠明确显示。命令示例：

  gcc your_source.o -o output -Wl,--verbose
  

  输出中的搜索路径片段：

  SEARCH_DIR("/usr/local/lib/x86_64-linux-gnu/");
  SEARCH_DIR("/lib/x86_64-linux-gnu/");
  SEARCH_DIR("/usr/lib/x86_64-linux-gnu/");
  SEARCH_DIR("/usr/local/lib/");
  

• 直接使用 ld 链接：
  如果直接调用链接器，可执行：

  ld --verbose -o output your_source.o -lmylibrary
  

三、大型项目适配（Makefile/CMake） #

若项目使用构建工具，可直接修改编译/链接参数：

• Makefile：
  在 CFLAGS（编译头文件）和 LDFLAGS（链接库）中添加对应参数：

  CFLAGS += -H
  LDFLAGS += -Wl,--verbose
  

• CMake：
  在 CMakeLists.txt 中设置全局编译/链接选项：

  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -H")
  set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--verbose")
  

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