Ubuntu下Qt版本冲突致编译失败，CMAKE_PREFIX_PATH设置无效求解决

这种Ubuntu预装Qt和自定义安装版本冲突的问题我碰到过好多次了，尤其是系统自带的旧版Qt（比如Qt5.12）和自己装的新版Qt（比如Qt6.x）共存时，CMake很容易优先捡系统的旧版本来用，导致编译时找不到新特性的函数。结合你遇到的CMake冲突提示，给你几个靠谱的解决方案：

有时候光设置CMAKE_PREFIX_PATH还不够，CMake可能还是会去系统默认目录找。你可以在find_package时明确指定版本，并且加上NO_CMAKE_SYSTEM_PATH参数，让CMake完全忽略系统预装的Qt：

# 替换成你自己的Qt安装路径，比如Qt6的gcc_64目录
set(QT_INSTALL_DIR "/home/your-user/Qt/6.5.3/gcc_64")
set(CMAKE_PREFIX_PATH ${QT_INSTALL_DIR})

# 明确指定需要的Qt版本和组件，禁用系统路径查找
find_package(Qt6 6.5 REQUIRED COMPONENTS Core Widgets NO_CMAKE_SYSTEM_PATH)

这样CMake就只会去你指定的目录找Qt，不会碰系统预装的旧版本了。

如果上面的方法还是不行，可以直接手动把Qt的头文件和库目录添加到CMake的搜索路径里，跳过find_package的自动查找逻辑（应急很有效，不推荐长期依赖）：

set(QT_INSTALL_DIR "/home/your-user/Qt/6.5.3/gcc_64")

# 添加Qt的头文件目录
include_directories(
    ${QT_INSTALL_DIR}/include
    ${QT_INSTALL_DIR}/include/QtCore
    ${QT_INSTALL_DIR}/include/QtWidgets
)

# 添加Qt的库文件目录
link_directories(${QT_INSTALL_DIR}/lib)

# 直接链接需要的Qt库
target_link_libraries(your-project-name PRIVATE Qt6::Core Qt6::Widgets)

Qt6及以后官方提供了qt-cmake脚本，它会自动帮你配置好所有正确的环境变量，完全避免系统版本的干扰。步骤如下：

1. 先source Qt的环境脚本（不同版本路径可能不同）：

source /home/your-user/Qt/6.5.3/gcc_64/bin/qt6-env.sh

2. 用qt-cmake代替普通的cmake来配置项目：

# 清理旧的build目录
rm -rf build
# 用qt-cmake生成构建文件
qt-cmake -S . -B build
# 编译
cmake --build build

这个方法是最省心的，官方推荐用来解决版本冲突问题。

有时候CMake会缓存之前的路径设置，即使你改了CMAKE_PREFIX_PATH也没用。这时候需要彻底删除build目录，重新配置：

rm -rf build
# 重新运行cmake时明确指定Qt路径
cmake -S . -B build -DCMAKE_PREFIX_PATH=/home/your-user/Qt/6.5.3/gcc_64

• 确认你设置的QT_DIR路径正确：可以进入该目录，检查是否有lib、include、bin这些子目录，以及lib/cmake/Qt6（对应Qt6）这样的CMake配置文件。
• 用命令行确认当前环境的Qt版本：运行qmake -v或者qt-cmake --version，看输出的版本是不是你需要的那个。

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