如何为CMake指定正确Qt5路径以成功编译MuseScore 4？

问题背景 #

从GitHub官方仓库克隆最新版MuseScore 4源码后，运行./build.cmake编译时持续报错：

CMake Generate step failed.  Build files cannot be regenerated correctly.
CMake Error at build.cmake:232 (message):
  Configure step failed with status 1.  See output above for details.

环境详情：

• 系统：GNU/Linux Debian Bullseye(11) AMD64
• CMake版本：3.25.1-1~bpo11+1
• Qt版本：5.15.2（QMake 3.1），qmake --version返回：

QMake version 3.1
Using Qt version 5.15.2 in /usr/lib/x86_64-linux-gnu

whereis qmake返回：qt5: /usr/lib/x86_64-linux-gnu/qt5 /usr/lib/qt5 /usr/share/qt5

已尝试操作：创建build_overrides.cmake文件并设置多种QTDIR路径，但报错未解决。

解决方案 #

1. 修正build_overrides.cmake的Qt配置 #

Debian系统中Qt5的标准根目录为/usr/lib/x86_64-linux-gnu/qt5，需同时配置PATH和CMake模块路径，确保CMake能正确定位Qt工具和依赖。修改build_overrides.cmake内容如下：

# 设置Qt5根目录
set(ENV{QTDIR} "/usr/lib/x86_64-linux-gnu/qt5")
# 将Qt的bin目录加入环境变量，确保CMake找到qmake
set(ENV{PATH} "$ENV{QTDIR}/bin:$ENV{PATH}")
# 明确指定Qt5的CMake模块路径
set(CMAKE_PREFIX_PATH "/usr/lib/x86_64-linux-gnu/qt5/lib/cmake" CACHE PATH "Qt5 CMake modules directory")

2. 安装完整的Qt5开发依赖包 #

MuseScore 4编译需要多个Qt5开发组件，执行以下命令安装缺失依赖：

sudo apt update && sudo apt install qt5-default qtbase5-dev qtdeclarative5-dev qtquickcontrols2-5-dev qttools5-dev qttools5-dev-tools libqt5svg5-dev libqt5webkit5-dev

3. 清理旧构建缓存后重新编译 #

残留的CMake缓存可能导致配置冲突，先清理再重新构建：

# 删除已生成的build目录
rm -rf build
# 重新运行构建脚本
./build.cmake

4. 直接通过构建参数指定Qt路径（备选） #

如果上述配置仍无效，运行build.cmake时直接传入CMake参数指定Qt模块路径：

./build.cmake -DCMAKE_PREFIX_PATH=/usr/lib/x86_64-linux-gnu/qt5/lib/cmake

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