AwesomeQt — Qt 6 中文深度教程
一套聚焦 C++ / QtWidgets 的 Qt 6 中文深度教程：三层递进（入门 → 进阶 → 读源码）+ 可复用实例库，把「学会 Qt」送到「做出东西」。隶属 Awesome-Embedded-Learning-Studio。
🌐 在线阅读：https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeQt/ · 教程与示例同步更新
这是什么
AwesomeQt 是一套 Qt 6 中文深度教程，隶属 Awesome-Embedded-Learning-Studio。
采用三层分级结构：
入门层 → 能跑起来，理解核心概念，知其然
进阶层 → 懂原理，写出工程级稳健代码
专家层 → 读懂 Qt 源码，每条结论带 文件:行号 证据
快速开始
前置检查
| 你需要… |
版本要求 |
| C++ 基础 |
熟悉类、继承、指针、模板 |
| CMake |
≥ 3.26 |
| 编译器 |
MSVC 2019/2022 / MinGW 11.2+ / GCC 11+ |
| 操作系统 |
Windows 10/11 / Linux / WSL2 |
三步跑起来
# 1. 克隆仓库
git clone https://github.com/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeQt.git
cd Tutorial_AwesomeQt
# 2. 阅读教程索引
# 打开 tutorial/index.md 选择你的起点
# 3. 从环境搭建开始
# tutorial/beginner/00-environment-setup/
如果你是零基础，建议按顺序从「环境搭建」开始。如果你已经有 Qt 经验，可以直接跳到感兴趣的模块。
当前进度
入门层 ██████████ 137 / 137 篇教程 · 141 个代码示例
进阶层 ██████████ 134 / 134 篇教程 · 134 个代码示例
专家层 ██░░░░░░░░ 19 / 102 篇（源码拆解 · 连载中）
实例库 ████████░░ 持续扩充 · src/ 下 widget / app / model / industrial（配双文档）
🚀🚀🚀 更加详细的进度：tutorial/index.md
更新日志
见 changelogs/ 目录。
学习路径
路径 A：零基础完整学习
环境搭建 → QtBase → QtGui → QtWidgets → 项目实战 → QtNetwork → 扩展模块 → QML
适合：从没接触过 Qt，想系统学习的开发者。
路径 B：Qt 5 老用户速成
环境搭建（重点 CMake）→ Qt 6 新变化 → 直接跳到感兴趣的模块
适合：有 Qt 5 经验，想快速迁移到 Qt 6 的开发者。
路径 C：源码深度钻研
完成入门层 → 专家层源码解析章节（MOC 原理、信号槽底层、事件循环...）
适合：想理解 Qt 底层实现的设计模式爱好者。
教程特色
📝 不是 API 手册
文档里不会列出所有函数签名，那些东西官方文档写得更好。我们讲的是：什么时候用什么、为什么这样用、哪里会踩坑。
🚧 踩坑实录
每个知识点至少三个真实踩过的坑：
> ⚠️ 坑 #N：[坑的名字]
> ❌ 错误做法：[描述或伪代码]
> ✅ 正确做法：[描述或伪代码]
> 💥 后果：[这样写会崩溃 / 内存泄漏 / 信号永远不触发...]
> 💡 一句话记住：[总结]
🧪 随堂测验
穿插在讲解中的互动题目，不只是读完就算：
- 📝 口述回答：用自己的话说说概念
- 🔲 代码填空：补全关键代码
- 🐛 调试挑战：找出有 bug 的代码
- 📖 源码阅读题（专家层）
🎯 练习项目
每篇配套一个动手项目，不做永远学不会。
🔗 验证过的官方文档链接
每篇末尾附上官方文档链接，全部经过验证可达。遇到疑问，官方文档是最终权威。
实例库 — 真成品，不是片段
项目内置一套实例库：src/widget/ 是可复用控件库（统一 AwesomeQt:: 命名空间），src/app/ 是整机应用。每件都是可独立编译的成品，配「成品导览 + 手搓手册」两套文档，落在 tutorial/engineering/instances/。
app 整机成品
构建方式： widget 控件为 STATIC 库 + 独立 demo，根 src/widget/CMakeLists.txt 统一配置（C++17 / AUTOMOC / find_package Qt6）；app 为整机 demo，根 src/app/CMakeLists.txt 统一配置。cd src/widget && cmake -B build && cmake --build build 即可构建。
致谢
本项目的代码实例规划大量参考了以下开源项目和社区资源，在此致以诚挚的感谢：
核心参考仓库
灵感来源与参考项目
如果您是以上项目的作者，且对本项目的引用方式有任何疑问或希望调整，欢迎通过 Issue 联系我们。
技术栈
| 项目 |
说明 |
| Qt 版本 |
6.9.1（编写时的 LTS） |
| 构建系统 |
CMake 3.26+ |
| C++ 标准 |
C++17/20 |
| 测试平台 |
Windows 10/11, Ubuntu 22.04+, WSL2 |
| 编译器 |
MSVC 2019/2022, MinGW 11.2+, GCC 11+ |
贡献与反馈
欢迎参与 AwesomeQt 的建设：修正错别字、改进示例、补充踩坑、新增章节都可以。
- 贡献前：请先读 贡献指南（文章五段结构、代码五件套、本地预览、提交前检查）。
- 报错或建议：用 Issue 模板（勘误 / 示例构建 / 站点问题 / 内容提案）。
- 用 AI 编程助手参与：先读 AGENTS.md。
如果你发现错误内容、失效链接、可改进的表达，或想补充知识点，欢迎提 Issue 或 PR。
许可
本仓库内容分档授权：示例与实例库代码（src/ 下的 examples/、widget/、app/、model/、industrial/）为 MIT；教程文档（tutorial/）为 CC BY-SA 4.0；专家层引用的 Qt 源码遵循 The Qt Company 自身许可。详见 NOTICE.md。
联系方式
下一步： 从 教程索引 选择适合你的起点，或查看 更新日志 了解最新进展。问题与建议欢迎提 Issue。
评论