Repository navigation
v0.2.0 迁移到VitePress与进阶层教程发布
v0.2.0 (2026-05-15)
进阶层首批内容上线,站点迁移至 VitePress,全站 metadata 标准化。我们的新网站已经上线!
已完成内容
进阶层 · Advanced — QtBase(16 篇)
| 编号 | 主题 |
|---|---|
| 1.1 | QObject 属性系统深度拆解 |
| 1.2 | 信号与槽:工程级深度剖析 |
| 1.3 | QString 深度性能与陷阱 |
| 1.4 | 容器高级用法:COW 真相与自定义哈希 |
| 1.5 | QVariant 与 QMetaType 深度实战 |
| 1.6 | 内存管理进阶:智能指针与循环引用 |
| 1.7 | 事件系统进阶:自定义事件与过滤器 |
| 1.8 | 文件 IO 进阶:序列化与文件监控 |
| 1.9 | 多线程进阶:线程池、并发与锁 |
| 1.10 | QProcess 进阶:异步读写与进程间通信 |
| 1.11 | 定时器进阶:高精度计时与性能分析 |
| 1.12 | 插件系统进阶:版本管理与热加载 |
| 1.13 | 国际化进阶:复数规则与动态语言切换 |
| 1.14 | 日志进阶:自定义处理器与分类过滤 |
| 1.15 | 正则进阶:命名捕获与性能分析 |
| 1.16 | JSON/XML 进阶:流式处理大文件 |
进阶层 · Advanced — QtGui(6 篇)
| 编号 | 主题 |
|---|---|
| 2.1 | QPainter 进阶:双缓冲、合成模式、抗锯齿 |
| 2.2 | 坐标变换进阶:矩阵组合与逆变换 |
| 2.3 | 图像处理进阶:像素操作与格式转换 |
| 2.4 | 字体进阶:富文本与 QTextDocument |
| 2.5 | OpenGL 进阶:着色器与 VAO/VBO |
| 2.6 | 拖放进阶:自定义 MIME 与跨应用拖放 |
进阶示例代码(22 个工程)
全部位于 examples/advanced/,CMake + Qt 6 可直接编译运行,覆盖上述 22 篇教程。
专家层占位
tutorial/expert/ 目录结构及全部 6 个模块的 index 占位页。
站点改进
VitePress 迁移
- 从 MkDocs Material 迁移至 VitePress
- 自动侧边栏生成(
buildSidebar()扫描目录结构) - 导航栏新增「进阶教程」下拉菜单
- 首页 Roadmap 更新:进阶层状态改为「编写中 · 22 篇已完成」
卡片布局
- 新增
CardGrid/CardLinkVue 组件 - 全部 12 个 index.md 从纯文本列表升级为响应式卡片网格
- 卡片支持序号标签、标题、描述,hover 动效,暗色模式适配
Metadata 标准化
- 全站 192 个 markdown 文件统一添加 frontmatter(
title+description) - 侧边栏标题精简:如 "现代Qt开发教程(新手篇)1.1——QObject 与元对象系统" → "1.1 QObject 与元对象系统"
安全修复
- C++ 模板转义插件从宽泛的 PascalCase 正则匹配改为显式 Vue 组件白名单,避免
<QWidget>等被误放行
内容数据
| 指标 | 数量 |
|---|---|
| 入门层教程 | 137 篇(v0.1.0) |
| 进阶层教程 | 22 篇(新增) |
| 代码示例工程 | 134 + 22 = 156 个 |
| 可复用控件库组件 | 1 个(StatusLED) |
| 构建系统 | CMake 3.26+ |
| Qt 版本 | 6.9.1 |
| C++ 标准 | C++17/20 |
| 支持平台 | Windows 10/11 / Ubuntu 22.04+ / WSL2 |
| 静态文档站 | VitePress(GitHub Pages) |
开发中
- 进阶层 · Advanced — QtWidgets 主题篇(预估 10 篇)
- 进阶层 · Advanced — QtNetwork(预估 6 篇)
- 进阶层 · Advanced — QML(预估 7 篇)
- 专家层 · Expert(预估 142 篇,含 MOC 原理、信号槽源码等)
- 更多项目实战 Session
- AwesomeQt Widgets 控件库(规划 500+ 自定义控件)