企业官网建设流程全解析

简介：本资源是一份基于Qt框架实现甘特图的完整C++源码工程，面向具备基础Qt开发经验的中初级开发者，解决项目管理类应用中任务时间轴可视化与交互控制的核心需求。代码采用模块化设计，涵盖数据模型（Task结构体、自定义QAbstractItemModel）、图形视图（QGraphicsScene/QGraphicsView驱动的甘特条渲染）、时间计算（QDateTime处理起止时刻）、用户交互（拖拽修改、双击弹窗编辑）及信号槽驱动的实时刷新机制，适用于桌面端跨平台项目调度工具开发。压缩包共12个文件，含5个头文件（.h）定义核心结构与界面组件、4个源文件（.cpp）实现逻辑与绘图、1个Qt工程配置文件（.pro）、1个说明文本（.txt）和1个用户配置文件（.user），总大小仅14KB，轻量易集成。已有3109人学习下载，读者可直接编译运行，快速掌握Qt自定义图表绘制、事件响应与MVC模式在时序可视化中的落地实践。

1. 甘特图不是PPT动画：这是个能拖拽、能缩放、能实时响应任务变更的QT原生控件

你有没有试过在Qt项目里硬塞一个Web甘特图组件？加载慢、样式难对齐、事件穿透像玄学，改个颜色都要翻三遍CSS。这个源码包彻底绕开WebView——它用纯QWidget+QPainter重写了甘特图渲染层，所有时间轴刻度、任务条、依赖连线、滚动区域全由Qt原生事件驱动。某高校实验室用它对接MES系统时，把200+并行工序的排程界面从卡顿3秒优化到毫秒级响应；更关键的是，它把“双击编辑工期”“拖拽调整起止时间”“Ctrl+滚轮缩放时间粒度”这些高频操作封装成可复用的信号槽，而不是让你在paintEvent里手写坐标换算。如果你正在开发生产调度、项目管理或资源协调类桌面应用，且需要甘特图和你的主窗口共享QStyle、响应QShortcut、支持高DPI缩放——别折腾QWebEngine了，这就是你该跑起来的第一份QT甘特图源码。

2. 架构拆解：三层结构如何让甘特图既轻量又可扩展

2.1 核心模块职责划分：Model-View-Controller的Qt化落地

这个项目没套用标准MVC模式，而是做了Qt风格的裁剪：GanttModel只管数据契约（任务ID、开始时间、持续天数、前置任务ID列表），不碰任何UI逻辑；GanttView继承自QAbstractScrollArea，负责坐标系映射、视口裁剪、鼠标拾取；最关键的GanttController是独立对象，它监听GanttView的鼠标事件，调用GanttModel的API更新数据，并触发GanttView重绘。这种解耦让二次开发时你能直接替换GanttModel为数据库代理，而不用动一行渲染代码。比如某公司把GanttModel改成对接SQLite，只改了构造函数里的loadFromDatabase()调用，其他模块零修改。

// ganttcontroller.h 关键接口声明 class GanttController : public QObject { Q_OBJECT public: explicit GanttController(GanttModel *model, GanttView *view, QObject *parent = nullptr); signals: void taskMoved(int taskId, const QDateTime &newStart, int newDuration); // 任务拖拽完成信号 void taskResized(int taskId, int newDuration); // 任务条拉伸信号 void timeScaleChanged(double scale); // 时间轴缩放信号 private slots: void onMouseEvent(QMouseEvent *e); // 所有鼠标交互入口 };

提示：GanttController不持有QGraphicsScene，所有绘制都在GanttView::paintEvent()中用QPainter完成。这意味着它天生支持Qt Quick混合渲染（通过QQuickWidget嵌入），也避开了QGraphicsView的内存泄漏黑匣子。

2.2 时间轴与任务条的坐标映射：为什么缩放不撕裂

甘特图最怕时间轴缩放后任务条错位。本项目用双重坐标系解决：逻辑坐标系（QDateTime）和像素坐标系（int）完全分离。GanttView维护m_timeScale（单位：像素/小时）和m_scrollOffset（水平滚动偏移量），所有坐标转换都走统一函数：

// ganttview.cpp 坐标转换核心方法 int GanttView::timeToX(const QDateTime &dt) const { // 将QDateTime转为相对于视口左边界的时间差（秒） qint64 secondsSinceOrigin = dt.secsTo(m_originTime); // 换算为像素位置，考虑缩放和滚动偏移 return static_cast<int>(secondsSinceOrigin * m_timeScale / 3600.0) + m_scrollOffset; } QDateTime GanttView::xToTime(int x) const { // 反向计算：像素位置转QDateTime double seconds = (x - m_scrollOffset) * 3600.0 / m_timeScale; return m_originTime.addSecs(static_cast<qint64>(seconds)); }

参数说明：

• m_originTime：时间轴原点（非视口左边界，而是逻辑起点，如项目开工日）
• m_timeScale：动态可调，初始值20.0表示1小时=20像素，缩放时仅修改此值
• m_scrollOffset：水平滚动条位置，不影响m_originTime，避免缩放时时间轴跳变

这种设计让缩放操作变成单变量更新，无需重新计算所有任务坐标——实测2000个任务时，缩放帧率稳定在60FPS。

2.3 依赖连线渲染：贝塞尔曲线如何避开任务条遮挡

任务间的依赖关系用带箭头的贝塞尔曲线绘制，但直接连起止中心点会穿过任务条。项目采用“三段式路径”：起点垂直向下→水平移动→终点垂直向上，再用QPainterPath::cubicTo()平滑化。关键在GanttView::drawDependencyLine()中计算控制点：

void GanttView::drawDependencyLine(QPainter &p, const TaskItem &from, const TaskItem &to) { QPoint start = taskCenterPoint(from); // 任务条中心点 QPoint end = taskCenterPoint(to); // 控制点：水平偏移量根据任务条间距动态计算，避免重叠 int offset = qAbs(start.y() - end.y()) > 40 ? 80 : 40; QPoint ctrl1(start.x(), start.y() + offset); QPoint ctrl2(end.x(), end.y() - offset); QPainterPath path; path.moveTo(start); path.cubicTo(ctrl1, ctrl2, end); p.strokePath(path, m_dependencyPen); drawArrowHead(p, end, path.angleAtPercent(0.99)); // 在终点画箭头 }

注意：taskCenterPoint()返回的是任务条视觉中心，而非数据模型中的时间点。这意味着即使任务条被用户拖拽拉伸，依赖线仍自动锚定到其渲染区域中心，无需手动同步。

3. 编译与运行：从零构建可执行文件的完整链路

3.1 环境准备：Qt版本与模块依赖的硬性要求

项目基于Qt 5.15.2 LTS构建（兼容Qt 6.2+，但需修改QPainter::drawText()的字体设置）。必须启用以下模块：

• corewidgetsgui（基础必选）
• sql（若启用SQLite后端，否则可注释掉ganttmodel_sql.cpp）
• xml（用于导入导出XML格式计划）

验证命令（Linux/macOS）：

# 检查Qt安装是否包含widgets模块 qmake -query QT_INSTALL_LIBS | xargs ls | grep widget # 输出应含 libQt5Widgets.so 或 Qt5Widgets.framework # 验证qmake能识别模块 qmake -project "CONFIG += c++17" "QT += widgets sql"

提示：Windows下若用MSVC编译器，需确保安装了Desktop development with C++工作负载，且Qt Creator的Kit配置中Compiler选择正确（x64 MSVC 2019而非MinGW）。

3.2 工程文件解析：pro文件里的隐藏配置项

gantt.pro不是简单罗列源文件，关键配置藏在注释和条件编译里：

# gantt.pro 片段 QT += core widgets gui sql xml CONFIG += c++17 # 启用高DPI适配（必须！否则4K屏上文字糊成一片） win32: DEFINES += QT_HIGHDPI_SUPPORT macx: QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.14 # 条件编译：禁用SQL后端时自动排除相关文件 !contains(CONFIG, no_sql_backend) { HEADERS += ganttmodel_sql.h SOURCES += ganttmodel_sql.cpp } # 资源文件：图标和样式表打包进二进制 RESOURCES += resources.qrc

常见错误：忘记在.qrc中声明resources.qss样式表，导致GanttView无法加载自定义配色。修复方法是在resources.qrc中添加：

<file>styles/gantt.qss</file>

3.3 首次编译踩坑：链接器报错undefined reference to 'vtable for GanttModel'的根因

现象：qmake生成Makefile后，make报大量虚函数表未定义错误，集中在GanttModel及其子类。

原因：GanttModel继承自QObject，但头文件中缺失Q_OBJECT宏，或moc未生成对应文件。Qt的元对象系统要求所有含信号/槽的类必须有Q_OBJECT，且.cpp文件需被moc处理。

解决步骤：

1. 检查ganttmodel.h是否在类声明前有#include <QObject>，类定义内是否有Q_OBJECT

   #ifndef GANTTMODEL_H #define GANTTMODEL_H #include <QObject> class GanttModel : public QObject { // 必须继承QObject Q_OBJECT // 必须存在！ public: // ... }; #endif

2. 运行moc手动验证：

   moc ganttmodel.h -o moc_ganttmodel.cpp # 若无输出则正常；若报错"Class GanttModel has no Q_OBJECT macro"，说明宏缺失

3. 清理重建：

   make clean && qmake && make

血泪经验：Qt Creator中若修改了含Q_OBJECT的头文件，必须右键该文件→"Run qmake"，否则IDE不会自动触发moc。

4. 避坑指南：那些让开发者凌晨三点还在抓头发的典型问题

4.1 现象：时间轴刻度显示为"1970-01-01"，所有任务条堆在左上角

原因：GanttView::setTimeRange()未被调用，或传入的QDateTime参数为无效值（如QDateTime::currentDateTime()在未初始化时返回空时间）。m_originTime默认为QDateTime()，即1970年起点。
解决：在main.cpp创建GanttView后立即设置有效时间范围：

GanttView *view = new GanttView; view->setTimeRange(QDateTime::currentDateTime().addDays(-7), QDateTime::currentDateTime().addDays(30));

4.2 现象：拖拽任务条时出现残影，松开鼠标后任务条闪回原位

原因：GanttController的onMouseEvent()中未正确处理QEvent::MouseButtonRelease事件，或GanttModel::moveTask()内部未发出dataChanged()信号，导致GanttView未触发重绘。
解决：检查GanttModel::moveTask()末尾是否调用：

emit dataChanged(index, index, QVector<int>() << Qt::DisplayRole);

4.3 现象：缩放时间轴后，鼠标悬停提示（tooltip）位置严重偏移

原因：GanttView::event()中拦截QEvent::ToolTip时，未用mapFromGlobal()将全局坐标转为视口坐标，直接用了QCursor::pos()。
解决：在GanttView::event()中修正：

if (e->type() == QEvent::ToolTip) { QHelpEvent *helpEvent = static_cast<QHelpEvent*>(e); QPoint localPos = mapFromGlobal(helpEvent->globalPos()); // 关键！ // 后续用localPos计算任务ID... }

4.4 现象：在高DPI屏幕（如Mac Retina）上，任务条高度只有1px，文字不可读

原因：GanttView::paintEvent()中硬编码了任务条高度（如height = 20），未乘以devicePixelRatio()。
解决：在paintEvent()开头获取缩放因子：

double ratio = devicePixelRatioF(); int taskHeight = static_cast<int>(20 * ratio); // 原20px改为适配DPI

4.5 现象：添加新任务后，依赖连线不显示，或连线指向错误任务

原因：GanttModel::addTask()中未调用beginInsertRows()/endInsertRows()，导致GanttView的rowsInserted()槽未触发，内部任务索引缓存未更新。
解决：严格按Qt Model/View规范实现：

bool GanttModel::addTask(const TaskData &data) { beginInsertRows(QModelIndex(), rowCount(), rowCount()); m_tasks.append(data); endInsertRows(); // 必须成对出现！ return true; }

5. 二次开发实战：给甘特图加上「资源占用热力图」功能

5.1 需求分析：为什么热力图不能简单叠加在任务条上

某制造企业提出需求：在甘特图底部增加资源（如机床、工程师）占用热力图，颜色深浅表示同一时段内该资源被多少任务占用。难点在于：

• 热力图需独立于任务条渲染，否则缩放时颜色块会拉伸变形
• 必须支持按资源类型筛选（只看"数控铣床"类资源）
• 热力图Y轴要与任务条Y轴对齐，但数据源不同（任务条按工序排序，热力图按资源ID排序）

解决方案：新增ResourceHeatmapView类，作为GanttView的兄弟控件（非子控件），通过QVBoxLayout与GanttView并列放置。两者共享m_timeScale和m_scrollOffset，但各自维护独立的paintEvent()。

5.2 核心代码：热力图渲染的三个关键改造点

第一步：扩展GanttModel接口，提供资源占用数据

在ganttmodel.h中添加：

struct ResourceUsage { QString resourceId; QString resourceName; QVector<QPair<QDateTime, int>> timeSlots; // 时间段+占用数量 }; QVector<ResourceUsage> getResourceUsage(const QDateTime &start, const QDateTime &end) const;

第二步：ResourceHeatmapView的坐标映射（复用GanttView逻辑）

// resourceheatmapview.cpp void ResourceHeatmapView::paintEvent(QPaintEvent *e) { QPainter p(this); p.setRenderHint(QPainter::Antialiasing); // 复用GanttView的时间映射逻辑 int leftX = parentView()->timeToX(m_startTime); int rightX = parentView()->timeToX(m_endTime); // 计算每个资源行的高度（适配DPI） double ratio = devicePixelRatioF(); int rowHeight = static_cast<int>(24 * ratio); for (int i = 0; i < m_resources.size(); ++i) { const auto &res = m_resources[i]; int y = i * rowHeight + 2; // 行间距 // 绘制资源名称 p.drawText(5, y + 18, res.resourceName); // 绘制热力图色块 for (const auto &slot : res.timeSlots) { int x1 = parentView()->timeToX(slot.first); int x2 = parentView()->timeToX(slot.first.addSecs(3600)); // 1小时块 int width = qMax(1, x2 - x1); // 根据占用数量设置颜色（0-5用蓝到红渐变） QColor color = getColorForCount(slot.second); p.fillRect(x1, y, width, rowHeight - 4, color); } } }

第三步：与GanttView同步滚动和缩放

在GanttView中添加信号，在ResourceHeatmapView中连接：

// ganttview.h signals: void timeScaleChanged(double scale); void scrollOffsetChanged(int offset); // resourceheatmapview.cpp 构造函数中 connect(ganttView, &GanttView::timeScaleChanged, this, &ResourceHeatmapView::onTimeScaleChanged); connect(ganttView, &GanttView::scrollOffsetChanged, this, &ResourceHeatmapView::onScrollOffsetChanged);

5.3 验证技巧：用单元测试快速验证热力图数据准确性

不要等UI渲染出来再调试——为getResourceUsage()写Qt Test：

// tst_heatmap.cpp void TestHeatmap::testResourceUsage_data() { QTest::addColumn<QDateTime>("start"); QTest::addColumn<QDateTime>("end"); QTest::addColumn<int>("expectedSlotCount"); QTest::newRow("8h-slot") << QDateTime::fromString("2023-01-01T08:00", "yyyy-MM-ddThh:mm") << QDateTime::fromString("2023-01-01T16:00", "yyyy-MM-ddThh:mm") << 8; // 应返回8个1小时时间段 } void TestHeatmap::testResourceUsage() { QFETCH(QDateTime, start); QFETCH(QDateTime, end); QFETCH(int, expectedSlotCount); GanttModel model; model.loadTestData(); // 加载预设的3个任务，占用同一资源 auto usage = model.getResourceUsage(start, end); QCOMPARE(usage.first().timeSlots.size(), expectedSlotCount); }

从那以后我每次加新渲染功能，都强制先写QTest验证数据层，再碰paintEvent()。省下至少两次重启Qt Creator的时间，也避免把逻辑错误误判为UI bug。希望帮到你。

本文还有配套的精品资源，点击获取