Qt项目使用zmq.hpp出现多个undefined reference错误该如何配置链接？

错误原因说明 #

你遇到的undefined reference类报错属于链接阶段错误，不是头文件找不到导致的——头文件已经被正常识别到了，只是编译器无法找到zmq_errno、zmq_strerror这些函数的实际实现代码，需要额外配置ZeroMQ的库文件链接规则。

解决步骤（Ubuntu 18.04 + Qt环境） #

1. 先安装系统ZeroMQ开发依赖（推荐）

优先用系统源的稳定版本，避免自己管理库文件的版本兼容问题，终端执行命令：

sudo apt install libzmq3-dev

安装完成后，头文件会自动放在/usr/include路径，库文件放在/usr/lib/x86_64-linux-gnu路径。

2. 修改Qt的.pro配置文件

你之前的配置只添加了头文件声明，没有加库链接规则，补充以下内容：

# 可选：如果后续系统头文件识别异常，可显式指定头文件搜索路径
INCLUDEPATH += /usr/include

# 核心配置：链接libzmq库
LIBS += -lzmq

另外建议把你之前加到HEADERS里的zmq.h、zmq.hpp、zmq_utils.h删掉，用系统自带的头文件即可，避免版本冲突。

3. 重新构建项目

修改完.pro文件后，先执行「清理」，再执行「执行qmake」，最后重新构建项目即可解决报错。

特殊情况说明 #

如果你一定要使用自己放在项目目录里的ZeroMQ版本，需要确认你项目中除了头文件之外，已经存放了对应编译好的libzmq.so动态库文件，假设库文件放在项目根目录的libs文件夹下，需要把.pro的配置改为：

# 指定自定义库文件的搜索路径
LIBS += -L$$PWD/libs -lzmq
# 显式指定你自己的头文件路径
INCLUDEPATH += $$PWD/Headers

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