Qt Creator Subdirs项目库依赖链接错误排查求助

环境信息 #

• 平台：Windows 11
• Qt版本：6.5.1
• Qt Creator版本：10.0.2

项目背景 #

采用Subdirs类型父项目管理两个子工程：coreApp（Qt Widgets应用）和coreLib（C++动态库），已配置子工程依赖与内部库引用。coreLib通过Qt Creator向导创建后新增Temp系列测试文件，在coreApp中调用库中类时出现链接错误。

项目结构 #

parentProject
   |- parentProject.pro
   |- coreApp
   |     |- coreApp.pro
   |     |- main.cpp
   |     |- mainwindow.cpp
   |- coreLib
         |- coreLib.pro
         |- corelib.h
         |- corelib.cpp
         |- coreLib_global.h
         |- Temp.h
         |- temp2.h
         |- temp2.cpp

问题现象 #

• 修改corelib.cpp内容可正常生效，coreLib.dll能被coreApp正常访问
• 头文件识别正常，Temp类的inline函数add()可正常运行
• 将Temp::add()实现移到Temp.cpp时，触发unresolved reference to Temp::add()链接错误
• 调用Temp2类时，触发unresolved reference to Temp2::Temp2()链接错误

困惑点 #

temp2.cpp已被编译（构建目录可见temp2.o文件），但未被包含到最终生成的dll中，求原因及解决办法。

解决方案 #

1. 检查coreLib.pro的源文件配置 #

Qt Creator向导生成的库项目默认仅将初始创建的corelib.cpp加入SOURCES变量，新增的temp2.cpp、Temp.cpp需要手动添加到coreLib.pro中：

SOURCES += \
    corelib.cpp \
    temp2.cpp \
    Temp.cpp

若遗漏源文件，编译时会生成对应的.o文件，但不会被链接进最终的dll，导致外部调用找不到符号。

2. 确保类/函数的导出宏正确使用 #

作为动态库，所有需要被外部访问的类和成员函数必须标记由coreLib_global.h定义的CORELIB_EXPORT导出宏：

• Temp.h示例：

class CORELIB_EXPORT Temp {
public:
    int add(int a, int b);
};

• temp2.h示例：

class CORELIB_EXPORT Temp2 {
public:
    Temp2();
};

未添加导出宏时，即使源文件被加入项目，符号也不会被导出到dll的导出表中，外部应用无法定位。

3. 验证子工程依赖与构建顺序 #

确保父项目parentProject.pro中正确配置子工程顺序，保证coreLib先于coreApp构建：

SUBDIRS += \
    coreLib \
    coreApp

coreApp.depends = coreLib

同时检查coreApp.pro中是否正确链接coreLib：

LIBS += -L$$PWD/../coreLib/$$BUILD_TYPE -lcoreLib
INCLUDEPATH += $$PWD/../coreLib
DEPENDPATH += $$PWD/../coreLib

4. 清理缓存并重新构建 #

构建缓存可能导致旧dll未更新，执行以下操作：

• 删除整个项目的构建目录
• 在Qt Creator中依次执行Build > Clean All和Build > Rebuild All

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