如何手动为Qt 5.x添加旧版本Qt Multimedia 5.4.3模块？

1. 修正项目.pro文件的路径配置 #

手动添加模块后，Qt不会自动识别头文件和库路径，必须在项目的.pro文件里明确配置：

• 先确认你下载的QtMultimedia 5.4.3的目录结构（比如解压后路径为D:/Qt_Old_Modules/QtMultimedia-5.4.3）
• 在.pro文件中添加以下配置（根据实际路径调整）：

# 头文件搜索路径，需覆盖所有子模块目录
INCLUDEPATH += D:/Qt_Old_Modules/QtMultimedia-5.4.3/include
INCLUDEPATH += D:/Qt_Old_Modules/QtMultimedia-5.4.3/include/QtMultimedia
INCLUDEPATH += D:/Qt_Old_Modules/QtMultimedia-5.4.3/include/QtMultimediaWidgets

# 库文件搜索路径
LIBS += -LD:/Qt_Old_Modules/QtMultimedia-5.4.3/lib
# 链接对应库（区分Debug/Release，Debug版库名通常带d后缀，比如Qt5Multimediad）
LIBS += -lQt5Multimedia
LIBS += -lQt5MultimediaWidgets

注意：如果库是Debug版本，要把库名改成带d后缀的形式，比如-lQt5Multimediad。

2. 检查QtMultimedia内部头文件引用 #

旧版本QtMultimedia的内部头文件可能依赖相对路径，若解压后的目录层级不对会导致内部引用失败：

• 打开QtMultimedia-5.4.3/include/QtMultimedia/qabstractvideosurface.h，检查内部include语句（比如#include <QtMultimedia/qvideosurfaceformat.h>）
• 确保.pro里的INCLUDEPATH已包含根include目录，让Qt能递归找到所有子目录下的头文件。

3. 验证库的编译兼容性 #

Windows下Qt库和编译器版本强绑定，若你下载的是预编译版QtMultimedia 5.4.3，必须和当前项目使用的Qt套件编译器一致（比如都是MSVC2013或MinGW 4.9）：

• 若预编译库不兼容，需要手动编译QtMultimedia 5.4.3源码：
  1. 导入QtMultimedia源码的qtmultimedia.pro到Qt Creator
  2. 选择和当前项目一致的编译器套件
  3. 编译生成Debug和Release版库文件，替换之前手动添加的库。

4. 清理缓存重新构建 #

旧的构建缓存可能导致路径配置不生效，按以下步骤操作：

• 删除项目的构建目录（在Qt Creator的"项目"面板中可找到构建路径）
• 点击Qt Creator工具栏的"运行qmake"按钮，然后重新执行构建。

内容的提问来源于stack exchange，提问作者Yusuf Adıbelli