如何在qmake中引入库文件且不硬编码编译器与Qt版本

Qt Creator自动生成的库路径会硬编码Qt版本、编译器等信息，确实不适合跨环境分发，以下是几种标准解决方案，无需让用户手动修改文件夹名称：

1. 利用qmake内置变量动态生成路径 #

通过qmake提供的环境变量，自动适配当前构建环境的Qt版本、编译器、架构等信息，动态拼接库路径：

# 定义库的基础路径模板，自动填充环境变量
LIB_BASE_PATH = $$PWD/../../../build-mylibrary-Desktop_Qt_$$QT_VERSION_$$QMAKE_CXX_COMPILER_ID_$$QMAKE_TARGET.arch

win32:CONFIG(release, debug|release): LIBS += -L$$LIB_BASE_PATH-Release/mylibrary/release/ -lmylibrary
else:win32:CONFIG(debug, debug|release): LIBS += -L$$LIB_BASE_PATH-Debug/mylibrary/debug/ -lmylibrary
else:unix: LIBS += -L$$LIB_BASE_PATH-Release/mylibrary/ -lmylibrary

INCLUDEPATH += $$PWD/../../../mylibrary
DEPENDPATH += $$PWD/../../../mylibrary

其中QT_VERSION自动获取当前Qt版本，QMAKE_CXX_COMPILER_ID识别编译器类型（如MSVC、GCC），QMAKE_TARGET.arch获取架构（如64bit），实现路径的自动适配。

2. 通过环境变量指定库根目录 #

让用户在系统环境变量中配置库的根路径，.pro文件读取该变量来定位库：

# 检查环境变量是否配置，未配置则抛出提示
isEmpty(MYLIBRARY_ROOT): error("请设置环境变量 MYLIBRARY_ROOT，指向mylibrary的根目录")

win32:CONFIG(release, debug|release): LIBS += -L$$MYLIBRARY_ROOT/build/release/ -lmylibrary
else:win32:CONFIG(debug, debug|release): LIBS += -L$$MYLIBRARY_ROOT/build/debug/ -lmylibrary
else:unix: LIBS += -L$$MYLIBRARY_ROOT/build/ -lmylibrary

INCLUDEPATH += $$MYLIBRARY_ROOT/include
DEPENDPATH += $$MYLIBRARY_ROOT/include

用户只需设置一次环境变量，即可适配任意Qt版本或编译器环境。

3. 用pri文件模块化管理依赖 #

将每个库的依赖配置单独抽离到.pri文件中，主.pro文件仅引入该pri，用户只需修改pri文件即可适配自己的环境：

mylibrary.pri内容： #

# 用户可根据自身环境修改以下路径
MYLIBRARY_BUILD_DIR = $$PWD/../../../build-mylibrary-Desktop_Qt_5_15_1_MSVC2019_64bit
MYLIBRARY_SRC_DIR = $$PWD/../../../mylibrary

win32:CONFIG(release, debug|release): LIBS += -L$$MYLIBRARY_BUILD_DIR-Release/mylibrary/release/ -lmylibrary
else:win32:CONFIG(debug, debug|release): LIBS += -L$$MYLIBRARY_BUILD_DIR-Debug/mylibrary/debug/ -lmylibrary
else:unix: LIBS += -L$$MYLIBRARY_BUILD_DIR-Release/mylibrary/ -lmylibrary

INCLUDEPATH += $$MYLIBRARY_SRC_DIR
DEPENDPATH += $$MYLIBRARY_SRC_DIR

主.pro文件引入： #

include($$PWD/mylibrary.pri)

这种方式能保持主.pro文件的干净，依赖配置的修改也更集中。

4. 切换到CMake构建（推荐） #

如果项目允许，CMake的find_package机制可自动查找库的位置，无需硬编码路径：

find_package(mylibrary REQUIRED)
target_link_libraries(your_project PRIVATE mylibrary::mylibrary)

只要库提供了正确的CMake配置文件（如mylibraryConfig.cmake），CMake就能自动识别头文件和库文件路径，完美适配不同构建环境。

内容的提问来源于stack exchange，提问作者adam.baker