如何在Qt5 CMake项目中正确处理包依赖问题

首先先给你现有CMakeLists.txt的小优化点：你现在三次调用find_package可以合并，减少冗余代码，修改后对应部分如下：

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

不需要分开三次找Qt和对应组件，一次列全所有需要的组件即可，找不到组件时CMake会直接报错，从配置阶段就暴露缺依赖的问题。

依赖跟踪的最佳实践 #

• 所有直接依赖必须在CMake中显式声明：你代码里直接调用的所有Qt模块、第三方库，都要第一时间加到find_package的组件列表里，绝对不要依赖“我本机已经装了所以能编过”的隐式环境。协作者拉取代码后跑CMake的阶段就能立刻知道缺什么依赖，不用等到链接、运行阶段才踩坑。
• 用工具补全间接依赖列表：你记不清之前装过的包，可以先在本机把项目编译出可执行文件，然后用ldd 你的可执行文件路径命令，会列出所有运行时需要链接的动态库，对应到你所用发行版的包名就能整理出完整依赖列表。比如gstreamer相关的包都是Qt Multimedia的间接依赖，ldd输出里会明确列出来对应的库文件。
• 维护明确的依赖安装文档：在项目根目录建说明文件，按不同发行版直接写好一键安装命令，比如Ubuntu/Debian系可以直接写：

  sudo apt install build-essential cmake qtbase5-dev qtmultimedia5-dev libgstreamer1.0-0 gstreamer1.0-plugins-base gstreamer1.0-plugins-good
  

  协作者复制粘贴就能装完所有依赖，不用自己逐个找包。
• 不要手动往项目lib文件夹拷贝你本机的系统库：你从自己系统里拷出来的Qt.so文件是绑定本机Qt版本、编译架构、甚至发行版版本的，换个机器大概率因为glibc版本、依赖版本不兼容跑不起来，还会污染项目目录，完全没必要。

你提到QtCreator里找不到QMultimedia组件的问题，本质是你本机没装对应Qt版本的Multimedia开发包，用系统包管理器安装对应开发包后重启QtCreator就能识别，不需要手动创建共享库。

是否需要内置打包所有依赖 #

分场景判断，不用现在就把所有精力放在打包上：

• 开发协作阶段完全不需要内置打包：Linux下C++项目开发的标准做法就是依赖系统包管理器提供的通用依赖，Qt作为非常成熟的跨平台框架，所有主流发行版的官方源都提供了预编译的安装包，只要你CMake声明全依赖、文档写清安装命令，协作者自己装依赖的成本极低，比你手动拷库靠谱得多。
• 最终用户分发阶段再做打包即可：等项目功能全部开发完成、准备发布给普通用户的时候，再处理依赖打包的事就行。跨平台分发有现成的工具可以自动收集依赖：Linux下可以打AppImage、Flatpak包，Windows下用Qt自带的windeployqt工具自动拷贝所有需要的Qt库、插件，macOS下用macdeployqt，不需要你手动一个个找依赖拷进去。这部分工作是项目收尾阶段的事，开发阶段优先保证代码逻辑和构建流程正确即可。

如果想彻底避免协作者之间的环境差异，可以额外写一个Dockerfile预装好所有依赖，所有人用统一的容器环境编译，能彻底解决“我本地能跑你那跑不了”的问题，但这属于可选优化，不是课程项目必须做的内容。

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