如何确保CMAKE_MODULE_PATH含FindQt5.cmake并构建Qt5多媒体MP3播放器？

正常情况下，Qt官方安装包或系统包管理器安装的Qt5，CMake会自动找到对应的FindQt5.cmake模块，无需手动配置。如果遇到找不到的情况，可通过以下方式解决：

• 指定Qt5的CMake配置目录
  直接设置Qt5_DIR变量指向Qt5安装目录下的CMake配置根目录，CMake会自动加载对应的模块文件，无需手动修改CMAKE_MODULE_PATH。

  • 在终端执行CMake前设置环境变量：

    export Qt5_DIR=/path/to/Qt5/5.x.x/your_compiler/lib/cmake/Qt5
    

  • 或者在CMakeLists.txt开头添加：

    set(Qt5_DIR "/path/to/Qt5/5.x.x/your_compiler/lib/cmake/Qt5")
    

  （替换/path/to/Qt5/5.x.x/your_compiler为你的实际Qt5安装路径，比如Windows下可能是C:/Qt/5.15.2/msvc2019_64/lib/cmake/Qt5）

• 手动添加Qt5的模块目录到CMAKE_MODULE_PATH
  Qt5安装目录下的lib/cmake文件夹包含所有Qt模块的配置文件，将该路径添加到CMAKE_MODULE_PATH中：

  list(APPEND CMAKE_MODULE_PATH "/path/to/Qt5/5.x.x/your_compiler/lib/cmake")
  

• 复制模块文件到项目本地
  从Qt5安装目录的lib/cmake/Qt5文件夹中找到FindQt5.cmake，复制到项目根目录的cmake子文件夹下，然后在CMakeLists.txt中添加：

  list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
  

• 检查系统默认CMake模块目录
  若通过系统包管理器（如Ubuntu的apt install qt5-default）安装Qt5开发包，FindQt5.cmake会被放置在系统默认的CMake模块目录中（比如/usr/share/cmake-x.x/Modules），此时CMAKE_MODULE_PATH默认已包含该路径，无需额外配置。

额外优化：统一CMakeLists.txt的Qt版本兼容 #

你的现有配置中存在版本不一致的问题（先通过QT_VERSION_MAJOR检测版本，后又硬编码Qt5），建议修改为兼容Qt5/Qt6的写法：

find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Widgets Multimedia)
find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Widgets Multimedia)

add_executable(MyMp3Player main.cpp mainwindow.cpp)

target_link_libraries(MyMp3Player PRIVATE Qt${QT_VERSION_MAJOR}::Widgets Qt${QT_VERSION_MAJOR}::Multimedia)

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