环境

• Win10
• CMake 3.23.0-rc2
• Qt Creator 6.0.2 Based on Qt 6.2.2 (MSVC 2019, 64 bit)

前言

有时候我们需要引用到Qt自带的一些头文件，比如使用quazip时，可以直接使用Qt自带的QtZlib，这时候你可能会直接在xxx.pro中加上如下一句：

INCLUDEPATH += D:\Qt\6.2.4\msvc2019_64\include\QtZlib

但由于使用了绝对路径，会导致你的项目可移植性较差。于是我们可以通过使用Qmake内置的环境变量来解决这一问题。

Qmake内置的环境变量

Qt6: https://doc.qt.io/qt-6/qmake-environment-reference.html
Qt5: https://doc.qt.io/qt-5/qmake-environment-reference.html
请先自行阅读上述官方文档，此处不对每个变量的含义和用法做冗余的描述。
针对上述例子，我们可以通过变量QT_INSTALL_PREFIX来得到D:\Qt\6.2.4\msvc2019_64，测试一下：

C:\Users\fygame>d:

D:\>cd D:\Qt\6.2.4\msvc2019_64\bin

D:\Qt\6.2.4\msvc2019_64\bin>qmake -query "QT_INSTALL_PREFIX"
D:/Qt/6.2.4/msvc2019_64

那么上面那句配置，就可以直接修改为：

INCLUDEPATH += $$[QT_INSTALL_PREFIX]\include\QtZlib

这样是不是就OK了呢？很不幸，在Windows上，你可能会在编译时依然查找不到相关的头文件，为什么呢？

注意斜杠和反斜杠的区别

我们来看看这两种方法生成的编译指令有什么区别

使用绝对路径

cl -c -nologo -Zc:wchar_t -FS -Zc:rvalueCast -Zc:inline -Zc:strictStrings -Zc:throwingNew -permissive- -Zc:__cplusplus -Zc:externConstexpr -Zi -MDd -std:c++17 -utf-8 -W3 -w34100 -w34189 -w44996 -w44456 -w44457 -w44458 -wd4577 -wd4467 -EHsc /Fd.obj\qztest.vc.pdb -DUNICODE -D_UNICODE -DWIN32 -D_ENABLE_EXTENDED_ALIGNED_STORAGE -DWIN64 -DNOMINMAX -DQT_QML_DEBUG -DQT_NETWORK_LIB -DQT_CORE5COMPAT_LIB -DQT_TESTLIB_LIB -DQT_CORE_LIB -DQT_TESTCASE_BUILDDIR="\"F:/tgit/qtprojects/build-quazip-0.7.3_Qt_6_2_4_MSVC2019_64bit-Debug/qztest\"" -I..\..\quazip-0.7.3-qt6\qztest -I. -I..\..\quazip-0.7.3-qt6\qztest -ID:\Qt\6.2.4\msvc2019_64\include\QtZlib -I..\..\quazip-0.7.3-qt6 -ID:\Qt\6.2.4\msvc2019_64\include -ID:\Qt\6.2.4\msvc2019_64\include\QtNetwork -ID:\Qt\6.2.4\msvc2019_64\include\QtCore5Compat -ID:\Qt\6.2.4\msvc2019_64\include\QtTest -ID:\Qt\6.2.4\msvc2019_64\include\QtCore -I.moc -ID:\Qt\6.2.4\msvc2019_64\mkspecs\win32-msvc -Fo.obj\ @C:\Users\fygame\AppData\Local\Temp\qztest.obj.355020.15.jom

注意到其中关于QtZlib的选项为-ID:\Qt\6.2.4\msvc2019_64\include\QtZlib

使用内置变量

cl -c -nologo -Zc:wchar_t -FS -Zc:rvalueCast -Zc:inline -Zc:strictStrings -Zc:throwingNew -permissive- -Zc:__cplusplus -Zc:externConstexpr -Zi -MDd -std:c++17 -utf-8 -W3 -w34100 -w34189 -w44996 -w44456 -w44457 -w44458 -wd4577 -wd4467 -EHsc /Fd.obj\qztest.vc.pdb -DUNICODE -D_UNICODE -DWIN32 -D_ENABLE_EXTENDED_ALIGNED_STORAGE -DWIN64 -DNOMINMAX -DQT_QML_DEBUG -DQT_NETWORK_LIB -DQT_CORE5COMPAT_LIB -DQT_TESTLIB_LIB -DQT_CORE_LIB -DQT_TESTCASE_BUILDDIR="\"F:/tgit/qtprojects/build-quazip-0.7.3_Qt_6_2_4_MSVC2019_64bit-Debug/qztest\"" -I..\..\quazip-0.7.3-qt6\qztest -I. -I..\..\quazip-0.7.3-qt6\qztest -ID:/Qt/6.2.4/msvc2019_64/include/QtZlib -I..\..\quazip-0.7.3-qt6 -ID:\Qt\6.2.4\msvc2019_64\include -ID:\Qt\6.2.4\msvc2019_64\include\QtNetwork -ID:\Qt\6.2.4\msvc2019_64\include\QtCore5Compat -ID:\Qt\6.2.4\msvc2019_64\include\QtTest -ID:\Qt\6.2.4\msvc2019_64\include\QtCore -I.moc -ID:\Qt\6.2.4\msvc2019_64\mkspecs\win32-msvc -Fo.obj\ @C:\Users\fygame\AppData\Local\Temp\qztest.obj.360680.31.jom

注意到其中关于QtZlib的选项为-ID:/Qt/6.2.4/msvc2019_64/include/QtZlib

结论

两者唯一的区别就是斜杠和反斜杠的不同。Windows路径使用的是反斜杠，而内置变量使用的是斜杠。于是，将上述配置语句再修改一下：

INCLUDEPATH += $$system_path($$[QT_INSTALL_PREFIX])\include\QtZlib

将斜杠替换为反斜杠，就可以通过编译了~
关于qmake函数的说明：
Qt6: https://doc.qt.io/qt-6/qmake-function-reference.html#system-path-path
Qt5: https://doc.qt.io/qt-5/qmake-function-reference.html#system-path-path