已完成多项排查仍出现QtCharts模块未安装报错，如何解决？

以下是触发报错的QML代码：

import QtQuick 2.15
import QtCharts 2.15

Rectangle {
    id: root
    width: 1392 * scaleFactor
    height: 436 * scaleFactor
    color: theme.item.color7

    ChartView {
        title: "Line Chart"
        anchors.fill: parent
        antialiasing: true

        LineSeries {
            name: "Line"
            XYPoint { x: 0; y: 0 }
            XYPoint { x: 1.1; y: 2.1 }
            XYPoint { x: 1.9; y: 3.3 }
            XYPoint { x: 2.1; y: 2.1 }
            XYPoint { x: 2.9; y: 4.9 }
            XYPoint { x: 3.4; y: 3.0 }
            XYPoint { x: 4.1; y: 3.3 }
        }
    }
}

已完成的排查步骤：

• 当前使用的Qt版本已安装Qt Charts模块，同路径下其他模块可正常工作
• .pro文件中已添加QT += charts配置
• 添加配置后重新运行了qmake，且确认生成的.exe为最新版本
• 卸载并重新安装过Qt Charts模块，问题仍未解决

可行的解决方向 #

1. 手动指定QML导入路径 #

在项目的main.cpp中，显式添加Qt Charts的QML模块路径，确保引擎能定位到该模块：

#include <QGuiApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;

    // 替换为你的Qt安装路径，注意匹配编译器架构（如msvc2019_64、gcc_64等）
    engine.addImportPath("<你的Qt安装目录>/5.15.2/<编译器架构>/qml/QtCharts");
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));

    return app.exec();
}

2. 验证编译器架构匹配 #

检查Qt Creator的Kit配置：

• 确认所选Qt版本的架构（x86/x64）与编译器（MSVC/GCC）的架构完全一致
• 避免混用32位和64位组件，比如用x64编译器却加载了x86版本的Qt Charts

3. 配置运行时环境变量 #

确保Qt Charts的动态库目录被加入系统PATH，或在项目Run配置中手动设置：

• 动态库路径示例：<Qt安装目录>/5.15.2/<编译器架构>/bin
• 在Qt Creator的「项目」→「运行」→「环境」中，添加或修改PATH变量，将上述路径加入

4. 检查QML模块文件完整性 #

直接前往Qt安装目录的qml/QtCharts文件夹，确认存在qmldir文件及相关.dll/.so库文件：

• 若目录缺失或文件不全，重新运行Qt Installer，选择对应Qt版本的Qt Charts模块，确保勾选完整组件

5. 清理项目缓存并重构 #

删除项目的build文件夹，重新执行qmake并构建项目：

• 旧缓存可能残留错误的模块路径配置，清理后重构可重置环境

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