QT项目重构：架构设计、构建工具选型及插件配置咨询

一、目录架构合理性 #

你规划的目录结构合理且符合Qt项目最佳实践：

• 根目录的Application.pro作为子项目入口，通过SUBDIRS管理主应用和功能库，实现统一构建流程；
• app/目录专注主应用的QML资源与入口逻辑，职责单一；
• libs/下按功能拆分charts、utils等独立库，实现代码解耦、复用，也方便单独开展单元测试。

二、是否需要抽象为独立QML模块 #

拆分决策取决于功能复用性与项目规模：

• 若为大型项目/可复用功能：非常有必要。将charts、utils封装为可导入的QML模块（如Application.Charts 1.0），可实现：
  • 代码解耦，各模块独立迭代，不影响主应用；
  • 方便在QML中通过import快速调用C++模型与自定义组件；
  • 后续其他Qt项目可直接复用这些库。
• 若为主应用专用的小型功能：暂时可不拆分，但长远来看，大型项目拆分模块是维护刚需，尤其是引入C++逻辑后，模块化能避免代码混乱。

三、Qt5下是否要从qmake切换到CMake #

建议趁重构时机切换到CMake，原因如下：

• CMake是Qt官方目前主推的构建系统，Qt5.12+对其支持已非常完善；
• CMake跨平台兼容性更好，生态更丰富（如集成第三方库更便捷）；
• 若后续计划升级到Qt6，CMake的迁移成本远低于qmake；
• 若项目已有大量复杂的qmake配置，迁移成本较高，也可先保留qmake完成重构，后续再逐步迁移。

四、QML插件搭建的简单示例与关键注意点 #

1. qmake版本示例（charts库） #

charts.pro配置：

QT += qml quick core
TEMPLATE = lib
CONFIG += plugin qmltypes
QML_IMPORT_NAME = Application.Charts
QML_IMPORT_MAJOR_VERSION = 1
QML_IMPORT_MINOR_VERSION = 0

# 指定插件输出目录，确保主应用能找到
DESTDIR = $$PWD/../plugins/Application/Charts
TARGET = $$QML_IMPORT_NAME

# 源文件
SOURCES += \
    chartmodel.cpp \
    chartplugin.cpp

HEADERS += \
    chartmodel.h \
    chartplugin.h

# QML资源（如果有自定义QML组件）
RESOURCES += charts.qrc

主项目Application.pro配置：

SUBDIRS += app libs/charts
# 指定插件搜索路径
QML2_IMPORT_PATH += $$PWD/libs/plugins

关键代码（chartplugin.cpp）：

#include "chartplugin.h"
#include "chartmodel.h"
#include <qqml.h>

void ChartPlugin::registerTypes(const char *uri)
{
    qmlRegisterType<ChartModel>(uri, 1, 0, "ChartModel");
    // 若有自定义QML组件，可通过qmlRegisterType注册或直接放在qrc中
}

2. CMake版本示例（charts库） #

CMakeLists.txt配置：

cmake_minimum_required(VERSION 3.16)
project(Charts)

set(CMAKE_CXX_STANDARD 11)
find_package(Qt5 REQUIRED COMPONENTS Core Qml Quick)

qt_add_qml_module(Charts
    URI Application.Charts
    VERSION 1.0
    SOURCES
        chartmodel.cpp chartmodel.h
        chartplugin.cpp chartplugin.h
    QML_FILES
        # 自定义QML组件文件
        LineChart.qml
)

target_link_libraries(Charts PRIVATE Qt5::Core Qt5::Qml Qt5::Quick)

主项目CMakeLists.txt配置：

cmake_minimum_required(VERSION 3.16)
project(Application)

find_package(Qt5 REQUIRED COMPONENTS Core Qml Quick)

add_subdirectory(app)
add_subdirectory(libs/charts)

# 确保主应用能找到QML模块
set(QML_IMPORT_PATH ${CMAKE_BINARY_DIR}/libs/charts CACHE STRING "QML import paths")

关键注意点： #

• QML模块的URI必须和import语句完全匹配；
• 插件的输出目录要加入主应用的QML2_IMPORT_PATH（qmake）或QML_IMPORT_PATH（CMake）；
• C++类要通过qmlRegisterType（Qt5全版本）或QML_ELEMENT宏（Qt5.14+）注册到QML；
• 测试时确保插件和主应用的构建目录一致，或者手动指定插件路径。

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