使用g++编译Qt代码时出现undefined reference错误，缺少什么编译标志？

你的问题出在编译参数的顺序上，而非缺少某个编译标志。

在GCC（g++）的链接阶段，链接器是按从左到右的顺序处理输入文件的：

• 如果先指定库文件（-lQt6Gui、-lQt6Core这类），此时链接器还没有看到你的源文件中需要的未定义符号，不会将库中的符号纳入引用；
• 当后续处理你的./test-qimage.cpp生成的目标文件时，遇到未定义的QImageReader相关符号，链接器已经处理过前面的库，不会回头去查找，因此抛出"undefined reference"错误。

修正后的编译命令 #

只需把pkg-config输出的库参数移到源文件之后即可：

g++ -xc++ -std=c++20 -fPIC -DQT_NO_VERSION_TAGGING ./test-qimage.cpp $(pkg-config --cflags --libs Qt6Gui Qt6Core) -o /tmp/test-qimage

或者拆分--cflags和--libs，结构更清晰（效果一致）：

g++ -xc++ -std=c++20 -fPIC -DQT_NO_VERSION_TAGGING $(pkg-config --cflags Qt6Gui Qt6Core) ./test-qimage.cpp $(pkg-config --libs Qt6Gui Qt6Core) -o /tmp/test-qimage

关键原理说明 #

链接器的符号查找逻辑是"按需加载"：只有先遇到未定义的符号需求，才会在后续的库文件中匹配对应的符号定义。调整参数顺序后，源文件先被处理，链接器先收集所有需要的符号，再从后面的Qt库中找到对应实现，就能完成正确链接。

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