VS2015+Qt5.7.1编译Qt4旧项目moc报错与LNK2001链接错误求解

你遇到的LNK2001链接错误和moc文件里的#error提示直接关联：moc工具解析头文件时没有识别到引入和Q_OBJECT宏，因此生成了带编译错误的moc文件，该文件会被跳过编译，最终导致类的metaObject()等Qt自动生成的虚函数缺失实现，触发链接报错。

• 优先解决预编译头和moc规则的冲突：
  右键报错对应的file_name.h文件，选择「属性」，切换到「Qt Meta-Object Compiler」配置页，将该文件的预编译头设置改为「不使用预编译头」；如果全局都开启了预编译头，可直接在项目的moc全局配置中去掉自动插入StdAfx.h的参数/FI"StdAfx.h"，也可以直接在StdAfx.h中添加#include <QObject>，让moc生成的代码在检测阶段就能读到对应的头文件定义。
• 彻底清理所有残留的旧版本生成文件：
  手动删除项目目录下所有GeneratedFiles文件夹的内容、Debug/Release输出目录、所有中间.obj文件，避免Qt4生成的旧moc文件或中间产物参与编译。
• 验证Qt配置一致性：
  打开VS菜单栏的「Qt VS Tools - Qt Project Settings」，确认当前项目绑定的Qt版本确实为5.7.1，检查项目包含目录、库目录没有混合引用Qt4的路径。
• 检查类声明规范：
  确认报错的<Class Name>类声明首行添加了Q_OBJECT宏，且该类直接或间接继承自QObject，Q_OBJECT宏没有放在类的private/protected块中；如果类定义在命名空间内，确认宏展开逻辑正常。
• 重新生成项目：
  右键项目选择「清理」，完成后再选择「重新生成」，不要仅点击普通生成，避免残留中间文件参与链接。

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