C++ matplot++库编译链接报错排查及第三方库使用问题求助

当前问题根因说明 #

• 你混淆了gcc编译参数的作用：-I仅用来指定头文件的搜索路径，动态/静态库的搜索路径需要通过-L参数单独指定。你没有配置-L参数指向matplot库文件的存放路径，链接器只会去系统默认的库搜索路径（如/usr/lib、/usr/local/lib等）查找libmatplot.so，找不到就会返回cannot find -lmatplot报错。
• 直接从GitHub克隆的仓库只有源码文件（.h/.cpp），没有预编译好的库文件，必须按照库的构建流程编译生成.so（动态库）或.a（静态库）文件后，才能被项目链接使用。你后续通过cmake加-DBUILD_SHARED_LIBS=ON生成目标文件的操作是正确的。
• 去掉-lmatplot后的报错是典型的符号未定义错误：编译器已经通过-I参数找到了matplot的头文件，所以编译阶段可以正常通过，但链接阶段找不到头文件中声明的类、函数的具体实现代码，本质还是没有正确链接编译好的matplot库文件。

当前问题修复步骤 #

1. 先确认matplot编译后生成的libmatplot.so文件的存放路径，假设你是在libs/matplot/build目录下完成的编译，对应路径就是./libs/matplot/build
2. 修改build.sh中的编译命令，补充-L参数，注意gcc参数顺序敏感：源文件放在最前，-I、-L参数依次放在中间，-l链接参数放在最后，修改后的命令示例：

g++ -Wall -I $(pwd)/libs -L $(pwd)/libs/matplot/build -g -o music_vis_cpp ./main.cpp -lmatplot -lstdc++fs -std=c++17 -pthread

3. 运行程序前需要把动态库路径加入系统库加载路径，避免运行时找不到库：

export LD_LIBRARY_PATH=$(pwd)/libs/matplot/build:$LD_LIBRARY_PATH
./music_vis_cpp

C++第三方库依赖问题通用排查思路 #

• 错误阶段拆分：把编译错误分为两类分别排查：
  • 编译阶段报xxx.h no such file or directory：头文件搜索路径配置错误，检查-I参数指向的路径是否包含对应头文件的父目录
  • 链接阶段报cannot find -lxxx：先确认你已经编译生成了libxxx.so/libxxx.a文件，再检查-L参数是否正确指向了库存放的目录
  • 链接阶段报undefined reference to xxx：确认库版本和代码要求的版本匹配、-l参数放在编译命令的后半段、所有依赖的子库都已经正确添加到链接参数中
• 库文件校验：引入第三方库时必须确认包内包含「头文件集合」+「编译好的库文件」两部分，仅源码包无法直接被项目链接使用，必须先完成库的编译构建流程
• 调试技巧：编译时添加-v参数可以打印完整的头文件、库文件搜索路径日志，能直接定位链接器到底在哪些路径搜索目标库，快速定位路径配置错误

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