Repository navigation
AwesomeQT在经过小两个月的各种痛苦的转型和打磨后,终于迈出了最艰难的一步:
进阶层全部完成(134 篇)、专家层启动(2/102 连载)、实例库从 1 件扩到 20 件真成品(控件 13 + 整机 7)、站点完成旗舰化改造(Qt 绿身份 + 三重 CI 质量门 + 可拖拽侧栏)。
已完成内容
进阶层 · Advanced — 全量完成(134 篇)
v0.2.0 上线了 QtBase 16 + QtGui 6 共 22 篇,本版补齐剩余 112 篇,进阶层 134 篇全部到位:
| 模块 | 篇数 | 说明 |
|---|---|---|
| QtBase | 16 | v0.2.0 已上线 |
| QtGui | 6 | v0.2.0 已上线 |
| QtWidgets | 74 | 布局 / 事件 / Model-View / QSS / 自定义绘制 / 对话框 / 主窗口 / 图形视图 / 动画 / MDI + 64 控件进阶 |
| QtNetwork | 6 | TCP / UDP / HTTP / WebSocket / SSL / 串口 |
| 扩展模块 | 25 | SQL / Charts / Multimedia / SVG / Bluetooth / MQTT / Modbus 等 |
| QML | 7 | 语法 / Controls / C++ 互操作 / 动画 / 模型视图 |
配套示例工程 examples/advanced/ 134 个,全部 CMake + Qt 6 可直接编译。
同时修复 issue #5:指针迭代的 const auto& 误导建议。
专家层 · Expert — 启动 + 规划敲定(2 / 102)
- 规划清单从 142 收敛到 102:控件双轨制(复杂控件三层全做,8 个 trivial 控件标「无专家层」)+ 砍 8 个小众模块(NFC / SCXML / WebEngine 等稳定后再评估)。完整清单见
todo/expert.md。 - 首批 2 篇成稿(源码拆解,每条结论带
qt_src/qt6.9.1 文件:行号可复现证据):- 01 COW 隐式共享
- 02 COW 容器实战
- 配套基础设施:code-index(按源码机制分片的行号索引)、claims-registry(已查证结论 append-only 复用表)、
.audit/交接单。
实例库 — 从 1 件扩到 20 件真成品
v0.2.0 只有 StatusLED 1 个控件,本版扩到 widget 13 + app 7 = 20 件。每件都是可独立编译的成品,配「成品导览 + 手搓手册」两套文档,统一 AwesomeQt:: 命名空间 + STATIC 库式构建。
widget 通用控件(13 件 · PR#10 / #14):
| 控件 | 类别 |
|---|---|
| StatusLED / ToggleSwitch | 状态 / 开关 |
| CircleProgress / SpeedMeter / LineChart | 自绘显示 |
| RangeSlider / EditableTable / CheckboxTree / CheckboxList | 交互输入 |
| LogViewer / PasswordEdit / IpEdit | 专项输入显示 |
| FadeAnimation | 动画 |
app 整机成品(7 件 · PR#16):
| 应用 | 说明 |
|---|---|
| image-viewer | 图片查看器(缩放 / 旋转 / 翻页 / 幻灯片) |
| json-editor | JSON 编辑器(格式化 / 校验 / 树) |
| sqlite-browser | SQLite 浏览器(表浏览 + 任意 SQL) |
| serial-tool | 串口调试助手(收发 + Hex/ASCII) |
| network-tool | TCP / UDP 调试工具 |
| tetris | 俄罗斯方块(自绘 + 消行计分) |
| cpu-memory-monitor | CPU / 内存监控(Windows 路径待实机复验) |
骨架就位:model 栏 undo-redo-framework(reference 范式)、industrial 栏 hmi-dashboard,待后续放量。
站点改进
旗舰化基建(PR#13)
- 单一真相源:抽
shared.ts统一 dev / build 双配置,根治历史defineConfig漂移。 - CI 质量门(四道):
build-check— VitePress 构建验证lint— markdownlint 强制拦截content-quality— 内部链接可达性 + 专家层源码引用验真build-examples— 275 个示例工程编译门(install-qt-action 装全套 Qt6 模块)
- SEO 基础:sitemap.xml + robots.txt + favicon 修复,供搜索引擎收录。
- 站点体验:代码折叠(>30 行)、字号五档切换、快捷键、页脚版本号、mermaid 图表渲染、首页 3D coverflow 轮播。
- License NOTICE:代码 MIT / 文档 CC BY-SA 4.0 / Qt 源码引用按 Qt Company 许可,分档授权写清。
- 贡献者入口:CONTRIBUTING / AGENTS / Issue & PR 模板。
- third_party submodule 钉到 release tag(benchmark v1.9.5 / googletest v1.17.0)。
站点样式大更新(PR#17)
- Qt 绿身份重塑:亮 / 暗双主题统一品牌色。
- 可拖拽侧栏:左右栏宽度可调,localStorage 持久化。
- 阅读进度条 + 长代码折叠 + 字号五档切换。
宣传门面统一
- README 加在线站点入口、实例库双表(widget 13 + app 7)、进度数字纠正、markdownlint 清零。
- 首页 tagline 改「聚焦 C++/QtWidgets · 三层递进 · 学→做闭合」。
- 专家层导航页按 102 篇重写。
内容数据
| 指标 | v0.2.0 | v0.3.0 |
|---|---|---|
| 入门层教程 | 137 篇 | 137 篇 |
| 进阶层教程 | 22 篇 | 134 篇(+112) |
| 专家层教程 | 0 篇 | 2 篇(连载中 · 规划 102) |
| 代码示例工程 | 156 个 | 275 个(+119) |
| 实例库成品 | 1 件 | 20 件(widget 13 + app 7) |
| 构建系统 | CMake 3.26+ | CMake 3.26+ |
| Qt 版本 | 6.9.1 | 6.9.1 |
| C++ 标准 | C++17/20 | C++17/20 |
| 支持平台 | Windows / Ubuntu / WSL2 | 同 |
| 静态文档站 | VitePress | VitePress(Qt 绿身份 + 拖拽侧栏) |
开发中
- 专家层 · Expert — 剩余 100 篇源码拆解(按 QtBase 硬核机制优先:MOC / activate 调用链 / 事件循环 / 对象树)
- 实例库 model 栏放量(17 件照 undo-redo-framework 范式)
- 实例库 industrial 栏 hmi-dashboard 成品化(复用 widget 递进链)