跨PC CMake构建失败调试：Qt6QuickCompiler查找异常排查

1. 核对CMake版本 #

CMake对Qt组件的查找逻辑可能随版本变化，先在两台机器上执行以下命令对比版本：

cmake --version

如果版本不一致，将故障机器的CMake升级到和正常机器相同的稳定版本（比如Ubuntu 24.04默认的CMake版本），再重新运行构建命令。

2. 检查Qt相关环境变量 #

即使包列表一致，环境变量配置差异也可能导致组件查找失败。执行以下命令对比两台机器的输出：

echo $QT_DIR
echo $PATH | grep qt
echo $CMAKE_PREFIX_PATH

如果正常机器有额外的Qt路径配置（比如/usr/lib/x86_64-linux-gnu/qt6/bin在PATH中，或CMAKE_PREFIX_PATH包含Qt根目录），将这些配置同步到故障机器的~/.bashrc或~/.profile中，生效后重试构建。

3. 定位Qt6QuickCompiler的实际路径 #

虽然正常机器没有/usr/lib/x86_64-linux-gnu/cmake/Qt6QuickCompiler目录，但该组件可能存在于Qt的Tools子目录中。在正常机器上执行以下命令查找配置文件：

sudo find / -name "Qt6QuickCompilerConfig.cmake" 2>/dev/null

找到路径后，在故障机器的CMake命令中手动指定该路径：

cmake ../cctv-viewer -DCMAKE_INSTALL_PREFIX=/usr/local --debug-find-pkg=Qt6QuickCompiler -DQT_DEBUG_FIND_PACKAGE=ON -DQt6QuickCompiler_DIR=/path/to/config-file-directory

4. 清理CMake缓存 #

故障机器的构建目录可能存在旧缓存干扰查找，删除后重新构建：

rm -rf build/*
cmake ../cctv-viewer -DCMAKE_INSTALL_PREFIX=/usr/local --debug-find-pkg=Qt6QuickCompiler -DQT_DEBUG_FIND_PACKAGE=ON

5. 检查全局CMake配置 #

对比两台机器的全局CMake配置文件：

cat /etc/cmake.conf
cat ~/.bashrc | grep cmake
cat ~/.profile | grep cmake

如果正常机器有额外的CMake模块路径配置，同步到故障机器，例如在~/.bashrc中添加：

export CMAKE_MODULE_PATH=/usr/lib/x86_64-linux-gnu/cmake/Qt6:$CMAKE_MODULE_PATH

6. 尝试禁用Qt6QuickCompiler（如果允许） #

查看项目的CMakeLists.txt，确认Qt6QuickCompiler是否为可选依赖。如果是，尝试禁用该组件构建：

cmake ../cctv-viewer -DCMAKE_INSTALL_PREFIX=/usr/local -DQT_QUICK_COMPILER=OFF

（具体参数需根据项目实际配置调整，可查看项目文档或CMakeLists.txt中的相关选项）

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