C++ Qt媒体播放器编译报PlayerFrame类多重定义问题求助

多重定义错误解决方案 #

1. 补全头文件包含保护 #

你当前的头文件仅保留了末尾的#endif，没有前置的包含保护逻辑，当头文件被多个源文件引用时会重复展开类声明，引发符号重复定义错误。同时先确认你代码中标注的头文件名拼写正确：你写的头文件名为playeframe.h，但源文件中引用的是playerframe.h，先保证文件名和引用名称完全一致。
在头文件最开头添加如下保护逻辑即可：

#ifndef PLAYERFRAME_H
#define PLAYERFRAME_H

// 此处保留你原有的头文件所有内容

#endif

也可以直接在头文件最开头加一行#pragma once实现更简便的包含保护。 #

2. 检查构建配置的源文件列表 #

如果你使用qmake/CMake等构建工具，可能playerframe.cpp被重复加入了编译源文件列表，导致同一函数被编译出多份符号，链接时触发冲突：

• 若使用qmake：检查项目.pro文件的SOURCES配置项，确认playerframe.cpp仅出现一次
• 若使用CMake：检查CMakeLists.txt的可执行文件/库配置，确认playerframe.cpp仅被添加一次

3. 清理Qt MOC缓存重新构建 #

因为你的类用到了Q_OBJECT宏，Qt的MOC工具会自动生成对应的moc中间文件，若缓存中存在旧的MOC文件，也可能引发符号冲突。直接删除整个构建目录的所有中间文件，完全重新编译项目即可。 #

4. 排查意外的cpp文件引用 #

确认项目中没有其他源文件写了#include "playerframe.cpp"的代码，直接引用cpp文件会把实现代码重复插入到多个编译单元，触发多重定义错误。

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