Qt5_DIR应设为Qt安装前缀下的lib/cmake/Qt5路径，如C:/Qt/5.15.2/msvc2019_64/lib/cmake/Qt5；优先通过cmake -DQt5_DIR=...命令行设置，其次环境变量或CMAKE_PREFIX_PATH（指向安装前缀）。
Qt5_DIR 环境变量或缓存变量怎么设？
CMake 报 could not find a package configuration file provided by "Qt5"，本质是它没找到 Qt5Config.cmake 文件。这个文件不在 Qt 安装根目录，而在 lib/cmake/Qt5 子目录下——比如 Windows 上常见路径是 C:/Qt/5.15.2/msvc2019_64/lib/cmake/Qt5，Linux/macOS 通常是 /opt/qt/5.15.2/gcc_64/lib/cmake/Qt5 或 ~/Qt/5.15.2/gcc_64/lib/cmake/Qt5。
设置方式有两种，优先级：命令行 > CMakeCache.txt > 环境变量：
- 命令行直接指定（最可靠，适合 CI 或临时调试）：
cmake -DQt5_DIR=/path/to/Qt5/lib/cmake/Qt5 .. - 在 CMakeLists.txt 中提前 set（不推荐，破坏可移植性）：
set(Qt5_DIR "/path/to/Qt5/lib/cmake/Qt5" CACHE PATH "") - 设置环境变量（仅影响当前 shell）：
Linux/macOS：export Qt5_DIR="/opt/qt/5.15.2/gcc_64/lib/cmake/Qt5"
Windows PowerShell：$env:Qt5_DIR="C:\Qt\5.15.2\msvc2019_64\lib\cmake\Qt5"
CMAKE_PREFIX_PATH 比 Qt5_DIR 更通用吗？
是的。CMAKE_PREFIX_PATH 是更推荐的方式，尤其当你同时用多个非标路径库（如 OpenSSL、FFmpeg）时。CMake 会自动在其子目录 lib/cmake/Qt5、share/cmake/Qt5 等位置搜索 Qt5Config.cmake。
设置方法：
- 命令行：
cmake -DCMAKE_PREFIX_PATH="/opt/qt/5.15.2/gcc_64" .. - 环境变量（Linux/macOS）：
export CMAKE_PREFIX_PATH="/opt/qt/5.15.2/gcc_64:$CMAKE_PREFIX_PATH" - 注意：路径必须是 Qt 安装前缀（即包含
lib/、bin/的那一层），不是lib/cmake/Qt5本身
find_package(Qt5 ...) 里版本号和组件写错会怎样？
版本号写错（比如写成 find_package(Qt5 5.16 REQUIRED) 但实际装的是 5.15.2）会导致 CMake 直接报错退出；组件名拼错（如把 Widgets 写成 widget 或 GUI）也会失败，因为组件名严格区分大小写且必须与 Qt5Config.cmake 中注册的一致。
常见可用组件包括：Core、Gui、Widgets、Network、Sql、Test 等。确认你安装的 Qt 版本是否真包含该组件——例如精简版或离线安装包可能不含 WebEngine。
建议写法：
- 只要基础 UI：
find_package(Qt5 REQUIRED COMPONENTS Core Gui Widgets) - 需要网络支持：
find_package(Qt5 REQUIRED COMPONENTS Core Network) - 避免写死版本号，除非项目强依赖某特性；
find_package(Qt5 5.15 REQUIRED ...)会拒绝 5.14.x
为什么有时候 Qt5_DIR 设对了还是找不到？
最常被忽略的是路径权限或符号链接问题。macOS 和某些 Linux 发行版（如 NixOS）中，Qt 安装路径可能含软链，而 CMake 默认不跟随符号链接查找 Qt5Config.cmake；另外，如果 Qt 是用 installer.run 安装的，部分版本会在 lib/cmake/ 下生成 Qt5 和 Qt5 两个目录，此时 Qt5_DIR 必须指向 Qt5 目录（不是 Qt5515 或类似变体）。
验证方法：
- 手动检查：
ls -l /path/to/Qt5/lib/cmake/Qt5/Qt5Config.cmake - 看 CMake 输出中的 “Looking for” 行，它会打印所有尝试过的路径
- 用
cmake -DCMAKE_VERBOSE_MAKEFILE=ON ..可看到更详细的查找过程
Qt5Config.cmake 文件必须可读，且其内部定义的 Qt5_DIR 值应与你传入的一致——否则 CMake 会二次校验失败。
