Qt 5.15下KDevelop不识别QGraphicsTextItem的setDefaultTextColor与setPos方法

首先明确两个前提：Qt 5.15 环境下QGraphicsScene::addText的返回值类型确为QGraphicsTextItem*，setDefaultTextColor、setPos也确实是该类（及父类QGraphicsItem）的公开方法，出现KDevelop无法识别的问题基本集中在三类场景，按出现概率从高到低排列：

1. 代码中对返回值的类型声明错误 #

这是绝大多数新手踩坑的核心原因：
addText的返回值必须以QGraphicsTextItem*类型接收，如果图省事用父类QGraphicsItem*指针承接返回值，编译器和静态检查工具就会因为类型不匹配，无法识别子类独有的setDefaultTextColor方法。

错误示例：

// 用父类QGraphicsItem*接返回值，会丢失子类方法的类型信息
QGraphicsItem *textItem = scene->addText("测试文本");
textItem->setDefaultTextColor(Qt::red); // 静态检查提示无此方法

注：setPos是QGraphicsItem基类自带的方法，如果出现连setPos都无法识别的情况，基本可以排除这一类问题。

2. 缺失对应类的显式头文件包含 #

如果代码中只写了class QGraphicsTextItem;这类前置声明，没有在编译单元中实际包含类的完整定义头文件，静态检查工具会将该类判定为不完整类型，自然无法识别其内部的所有成员方法。
必须显式在对应源文件中包含两个头文件，不要依赖Qt框架的隐式间接包含：

#include <QGraphicsScene>
#include <QGraphicsTextItem>

3. KDevelop 自身的代码索引/工程配置错误 #

如果排除了上面两个代码层面的问题，代码实际执行qmake/cmake编译可以正常通过、无任何报错，但KDevelop仍然标红提示方法不存在，属于KDevelop的静态分析模块的常见问题：

• 检查KDevelop的Qt工程配置，确认工程关联的Qt版本是你当前使用的5.15路径，没有错误指向系统自带的旧版Qt（比如Qt4）的头文件路径
• 清空损坏的索引缓存：关闭当前工程，删除项目目录下.kdev4文件夹内的缓存文件，或者在KDevelop的「语言支持-Clang」配置页选择重置全量索引，重启后等待KDevelop重新完成工程索引加载即可。

可正常运行的标准写法参考 #

QGraphicsScene *mainScene = new QGraphicsScene(this);
// 以正确的子类类型接收addText返回值
QGraphicsTextItem *tipText = mainScene->addText("功能提示文本");
// 两个方法都可以正常识别调用
tipText->setDefaultTextColor(QColor("#ff4444"));
tipText->setPos(20, 50);

补充说明：Qt开发工具链中，编译器的头文件查找路径和IDE的静态分析查找路径是完全独立的两套系统，出现「能编译但IDE标红」的情况基本都是IDE侧的索引配置问题，不属于代码逻辑错误。

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