Ubuntu20.04编译软件时CMake无法找到Qt5SVG及uitools组件的问题

1. 先处理project()警告问题 #

CMake要求在CMakeLists.txt的最开头（find_package语句之前）添加project()命令，示例如下：

project(YourAppName LANGUAGES CXX)

这不仅能消除警告，还能确保CMake的项目上下文逻辑正确，避免后续包查找出现异常。

2. 解决Qt5SVG找不到的问题 #

• 确认依赖包是否正确安装：
  执行以下命令检查libqt5svg5-dev是否已安装：

  dpkg -l | grep libqt5svg5-dev
  

  如果无输出，说明未安装，执行以下命令安装：

  sudo apt update && sudo apt install libqt5svg5-dev
  

• 手动指定CMake查找路径：
  Ubuntu 20.04中Qt5SVG的配置文件默认路径为/usr/lib/x86_64-linux-gnu/cmake/Qt5SVG/。若已安装但CMake仍找不到，可手动指定路径：

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

  或直接指定Qt5SVG的配置目录：

  cmake . -DQt5SVG_DIR=/usr/lib/x86_64-linux-gnu/cmake/Qt5SVG/
  

3. 解决Qt5UiTools找不到的问题 #

Ubuntu 20.04中，Qt5UiTools模块的开发依赖包含在qttools5-dev包中，执行以下命令安装：

sudo apt update && sudo apt install qttools5-dev

安装完成后重新执行cmake .即可。

4. 通用调试方法 #

• 查看CMake详细查找日志：
  启用verbose模式，查看CMake查找组件的完整过程，定位缺失配置文件的路径：

  cmake . -DCMAKE_VERBOSE_MAKEFILE=ON
  

• 检查CMake变量：
  执行以下命令查看所有CMake变量（重点关注Qt相关路径）：

  cmake . -LA
  

  确认Qt5_DIR、Qt5SVG_DIR、Qt5UiTools_DIR指向的路径存在且包含对应的Config.cmake文件。
• 手动指定Qt5根目录：
  若CMake无法自动识别Qt5安装位置，直接指定Qt5的配置目录：

  cmake . -DQt5_DIR=/usr/lib/x86_64-linux-gnu/cmake/Qt5/
  

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