Learning Atlas · 2026

Qt × C++
十个必读开源项目

从三万行的存储引擎到百万行的即时通讯客户端。这份清单按「先读懂小项目、再进入大工程」的顺序排列, 每个项目都附了源码导读路径与构建方式 —— 代码已经下载到本地,随时可以打开对照阅读。

项目 10 代码量 250.5 万行 源码 0.2 GB 本地路径 QtCpp-Projects/code
250.5 万行
已下载代码总量
7,911个
源码文件
5 + 5
Qt 应用 / C++ 基础库
3 阶段
建议学习路径
01

速查表

按类别排列,末列为建议阅读顺序

#项目类别代码量难度顺序
01 DB Browser for SQLitesqlitebrowser/sqlitebrowser Qt 应用 5.0 万
#4
02 KeePassXCkeepassxreboot/keepassxc Qt 应用 14.4 万
#7
03 qBittorrentqbittorrent/qBittorrent Qt 应用 11.3 万
#8
04 OBS Studioobsproject/obs-studio Qt 应用 44.9 万
#9
05 Telegram Desktoptelegramdesktop/tdesktop Qt 应用 127.7 万
#10
06 fmtfmtlib/fmt C++ 基础库 7.1 万
#1
07 GoogleTestgoogle/googletest C++ 基础库 8.8 万
#2
08 nlohmann/jsonnlohmann/json C++ 基础库 17.9 万
#3
09 Dear ImGuiocornut/imgui C++ 基础库 10.4 万
#6
10 LevelDBgoogle/leveldb C++ 基础库 2.9 万
#5
02

学习路线

不要按编号读,按这个顺序读

PHASE 1 · 2–3 周

把语言工具磨利

先建立「现代 C++ 长什么样」的判断力,再写 Qt 代码才不会用过时写法。
1fmt2GoogleTest3nlohmann/json
PHASE 2 · 1 个月

读一个完整的小程序

从「看得懂单个文件」到「看得懂一个工程」,建立目录、构建、调试的整体感。
4DB Browser5LevelDB6Dear ImGui
PHASE 3 · 2–3 个月

进入真实大型工程

大项目不要通读,带着问题读:只看一条主线,比如「一次点击发生了什么」。
7KeePassXC8qBittorrent9OBS10Telegram
📌 读源码的正确姿势:先跑起来 → 找到入口 main() → 顺着一条功能链路断点跟一遍 → 再回头补架构。 一天读两小时、坚持三个月,胜过周末突击三天。
03

十个项目详解

每个项目附源码入口与阅读顺序

01

DB Browser for SQLite Qt 应用 Qt 入门首选

sqlitebrowser/sqlitebrowser · ⭐ - · GPL-3.0

体量最小的完整 Qt 桌面程序,一天读通主干

5.0 万代码行数
183源码文件
15 MB仓库体积
0 / 22QML / .ui 文件
3–5 天建议投入

为什么值得读

五万行以内、目录扁平、无外部依赖,却覆盖了一个真实桌面软件的完整要素:主窗口、多文档、对话框、表格模型、文件导入导出、SQL 编辑器、设置持久化。它是「第一次通读一个 Qt 项目」成本最低的选择,读完能建立对 QWidgets 工程的整体直觉,再去啃大项目就不会迷路。

核心知识点

QWidgets 布局体系与 sizeHintQAction / 菜单 / 快捷键组织QAbstractTableModel 与 QTableView 配合QSettings 持久化CMake + windeployqt 打包原生 C 库的 C++ 封装手法

怎么跑起来

cmake -B build -DCMAKE_PREFIX_PATH="C:/Qt/6.8.0/msvc2022_64"
cmake --build build --config Release
依赖:自带 sqlite3 源码,除 Qt 外无需外部依赖
本地路径:QtCpp-Projects/code/sqlitebrowser

源码导读(按这个顺序看)

  • src/main.cpp启动流程:单实例、命令行参数、翻译加载
  • src/MainWindow.cpp主窗口装配:菜单、QAction、Dock、标签页
  • src/sqlitedb.cpp数据库抽象层,看 C API 如何被封装成 RAII 对象
  • src/sqlitetablemodel.cpp自定义表格模型 + 分页加载,模型/视图核心
  • src/EditTableDialog.cpp对话框 + 表单布局 + 校验,最典型的 QWidgets 写法
  • src/ImportCsvDialog.cpp文件导入:向导式交互与进度反馈
难度
入门 建议第 4 个读
02

KeePassXC Qt 应用 架构范本

keepassxreboot/keepassxc · ⭐ - · GPL-2.0/3.0

分层最干净的 Qt 工程,业务与界面彻底解耦

14.4 万代码行数
940源码文件
35 MB仓库体积
0 / 72QML / .ui 文件
1–2 周建议投入

为什么值得读

很多 Qt 项目把逻辑堆进窗口类,KeePassXC 反过来:src/core 是纯领域模型,src/gui 只负责呈现,src/format 与 src/crypto 是可独立测试的模块,tests/ 与源码目录一一对应。想学「Qt 项目该怎么分层」「C++17 该怎么写」,这是最好的中文可读范本;顺带还能读懂 KDBX 加密数据库的文件格式。

核心知识点

分层架构与依赖方向C++17(optional / string_view / 结构化绑定)Qt 信号槽的解耦用法KDF 与对称加密的正确封装CMake 编译开关裁剪功能QTest 单元测试

怎么跑起来

cmake -B build -DCMAKE_BUILD_TYPE=Release -DWITH_XC_ALL=OFF
cmake --build build -j
依赖:Qt 5.15+/Qt 6、libgcrypt、argon2、zlib;Windows 可用 vcpkg 一次装齐
本地路径:QtCpp-Projects/code/keepassxc

源码导读(按这个顺序看)

  • src/main.cpp应用初始化、异常兜底、单实例与锁文件
  • src/core/Database.cpp领域模型:QObject + 信号驱动,不依赖任何界面
  • src/gui/MainWindow.cpp动作体系与界面状态的同步方式
  • src/format/Kdbx4Reader.cppKDBX4 文件格式解析,二进制 + XML 复合结构实战
  • src/crypto/SymmetricCipher.cpp加密抽象与 OpenSSL/gcrypt 后端切换
  • src/crypto/kdf/Argon2 / AES-KDF 密钥派生,安全代码怎么写
  • tests/TestDatabase.cpp与源码同构的单元测试组织方式
难度
进阶 建议第 7 个读
03

qBittorrent Qt 应用 大型桌面应用

qbittorrent/qBittorrent · ⭐ - · GPL-2.0+

Qt Widgets 工业级写法:模型/视图、多线程、内置 Web 服务

11.3 万代码行数
769源码文件
63 MB仓库体积
0 / 37QML / .ui 文件
2–3 周建议投入

为什么值得读

它回答了「真实项目里 Qt 怎么用」:种子列表是标准的 QAbstractItemModel + 排序过滤代理 + 自绘 delegate,网络层跑在 libtorrent 的独立线程里,通过信号槽回到 UI;此外项目自己用 Qt 写了一个 HTTP/WebUI 服务端。想学 Qt 的模型/视图与跨线程通信,这一份代码就够了。

核心知识点

Model/View 与 QSortFilterProxyModel跨线程信号槽(QueuedConnection)QSettings 与配置迁移Qt 网络模块与 HTTP 服务国际化 tr() 与 .ts 文件插件式搜索扩展

怎么跑起来

cmake -B build -G "Visual Studio 17 2022" -DCMAKE_BUILD_TYPE=Release
# 依赖 libtorrent 2.0 / Boost / OpenSSL,建议用 vcpkg 安装
依赖:Qt 6.5+、libtorrent-rasterbar 2.0、Boost、OpenSSL
本地路径:QtCpp-Projects/code/qBittorrent

源码导读(按这个顺序看)

  • src/app/main.cpp启动顺序、参数解析、单实例与 UI 初始化
  • src/gui/transferlistwidget.cpp视图层:列、排序、右键菜单、拖放
  • src/gui/transferlistmodel.cpp自定义 QAbstractItemModel,注意 begin/endInsertRows
  • src/base/bittorrent/sessionimpl.cpp会话生命周期与异步事件如何桥接到 UI
  • src/webui/webapplication.cpp用 Qt 实现 HTTP 服务:路由、鉴权、静态资源
  • src/gui/programupdater.cpp网络请求 + JSON 解析 + 版本比较
难度
较难 建议第 8 个读
04

OBS Studio Qt 应用 插件化架构

obsproject/obs-studio · ⭐ - · GPL-2.0

C 内核 + C++ 封装 + Qt 前端,插件架构教科书

44.9 万代码行数
1,805源码文件
38 MB仓库体积
0 / 43QML / .ui 文件
3–4 周建议投入

为什么值得读

一个巨型项目如何把「性能敏感的内核」和「快速迭代的界面」拆开?OBS 的答案是:libobs 用纯 C 写成对象系统(结构体 + 函数指针 + 引用计数),前端用 C++/Qt,两者只通过一组稳定的 C ABI 交互,功能全部以插件形式加载。这是理解「插件化」「ABI 稳定」「音视频管线」的最佳样本。

核心知识点

C 面向对象(不透明指针 + 函数表)引用计数与生命周期动态库加载与插件注册音视频时间戳与同步Qt 与原生线程/回调的边界大型 CMake 多目标工程

怎么跑起来

# Windows 官方脚本(依赖多,首次约 1 小时)
CI/windows/build.ps1
# 或先只读源码,用官方安装包对照调试
依赖:FFmpeg、x264、Qt6、libcurl 等十余个依赖;建议直接用官方构建脚本
本地路径:QtCpp-Projects/code/obs-studio

源码导读(按这个顺序看)

  • frontend/obs-main.cpp前端入口:QApplication 与 OBSApp 的创建顺序
  • frontend/OBSApp.cpp模块加载、配置、热键、主题初始化
  • frontend/widgets/OBSBasic.cpp主窗口:场景/源/混音器 Dock 的组织方式
  • libobs/obs.cC 语言实现的对象模型:引用计数、信号、上下文
  • libobs/obs-source.c源的生命周期与异步渲染
  • plugins/obs-ffmpeg/最完整的输出/编码插件示例
  • libobs/obs-module.h插件 ABI 边界,看清哪些能跨版本
难度
硬核 建议第 9 个读
05

Telegram Desktop Qt 应用 超大型工程

telegramdesktop/tdesktop · ⭐ - · GPL-3.0

百万行级 Qt 项目的组织方式与自绘 UI

127.7 万代码行数
3,204源码文件
64 MB仓库体积
0 / 0QML / .ui 文件
按需选读建议投入

为什么值得读

它证明了 Qt 能撑起超大型应用,也展示了代价:为了像素级还原设计稿,Telegram 在 Qt 之上自建了一套控件库与动画系统,协议层(MTProto)完全自研。读它不必逐行,重点看「目录如何切分」「自绘控件如何写」「异步网络如何组织」——这是从「会用 Qt」到「能设计 Qt 架构」的分水岭。

核心知识点

超大型 CMake 工程组织自绘控件与动画异步任务与回调生命周期网络协议实现本地缓存与增量同步跨平台打包

怎么跑起来

# 需要 TG_OWT 等子模块,Windows 构建极重
# 建议:只读源码 + 对照官方 Release 版行为
依赖:Qt 6、TG_OWT、OpenSSL、zlib 等,编译产物以 GB 计
本地路径:QtCpp-Projects/code/tdesktop

源码导读(按这个顺序看)

  • Telegram/SourceFiles/core/launcher.cpp启动器:单实例、更新、崩溃处理
  • Telegram/SourceFiles/mainwidget.cpp主窗口与三栏自适应布局
  • Telegram/SourceFiles/ui/widgets/自研控件库:按钮、输入框、动画
  • Telegram/SourceFiles/mtproto/协议栈:连接、加密、重传
  • Telegram/SourceFiles/data/data_session.cpp数据层与本地缓存
  • Telegram/SourceFiles/boxes/弹窗体系,看复杂交互如何拆分
难度
硬核 建议第 10 个读
06

fmt C++ 基础库 现代 C++ 入门

fmtlib/fmt · ⭐ - · MIT

std::format 的参考实现,模板与性能的平衡术

7.1 万代码行数
81源码文件
3 MB仓库体积
0 / 0QML / .ui 文件
3–5 天建议投入

为什么值得读

如果你想找一个小而美、能逐行读完的现代 C++ 库,就是它。它把「编译期格式串检查」「类型擦除」「可变参数模板」「高性能整数转字符串」这些硬核技巧,压缩在两万行上下的库代码里,而且是 C++20 std::format 的主要参考实现——读它就等于提前读懂标准库。

核心知识点

可变参数模板与折叠表达式constexpr 编译期计算类型擦除与虚表替代方案SFINAE / concepts 约束高性能数值转字符串算法头文件库与静态库双形态

怎么跑起来

cmake -B build -DFMT_TEST=ON -DFMT_DOC=OFF
cmake --build build
依赖:无第三方依赖;C++11 起可用,也可 header-only 直接 include
本地路径:QtCpp-Projects/code/fmt

源码导读(按这个顺序看)

  • include/fmt/core.h类型擦除核心:format_arg、type_mapper、iterator 适配
  • include/fmt/format.h编译期格式串解析与 FMT_COMPILE
  • include/fmt/chrono.h如何为自定义类型扩展格式化能力
  • src/format.cc运行时实现、本地化与异常路径
  • test/format-test.cc按特性组织的测试,等价于一份规格说明
难度
入门 建议第 1 个读
07

GoogleTest C++ 基础库 工程能力

google/googletest · ⭐ - · BSD-3-Clause

C++ 单元测试事实标准,也是宏与注册机制教材

8.8 万代码行数
190源码文件
4 MB仓库体积
0 / 0QML / .ui 文件
2–3 天建议投入

为什么值得读

不会写测试的 C++ 工程师走不远。GoogleTest 代码量适中、结构清晰,samples/ 里有十个循序渐进的例子,两天就能上手;再往里读,能看到「静态注册表」「宏生成类」「死亡测试用 fork 验证进程崩溃」这些相当漂亮的工程手法。

核心知识点

宏与静态注册机制RAII 管理测试生命周期参数化测试与类型化测试gmock 与依赖注入CMake target 设计与导出跨平台进程控制

怎么跑起来

# 作为子目录引入
target_link_libraries(my_test PRIVATE gtest_main)
# 或独立构建
cmake -B build -DBUILD_GMOCK=ON
依赖:无第三方依赖,CMake 即可
本地路径:QtCpp-Projects/code/googletest

源码导读(按这个顺序看)

  • googletest/samples/十个官方示例,从这里开始,一天一个
  • googletest/include/gtest/gtest.h公开 API 总入口,先看接口设计
  • googletest/src/gtest.cc断言、测试注册表、运行器主循环
  • googletest/src/gtest-death-test.cc死亡测试:子进程、信号、超时
  • googlemock/src/gmock-spec-builders.ccmock 的期望与调用匹配实现
难度
入门 建议第 2 个读
08

nlohmann/json C++ 基础库 API 设计

nlohmann/json · ⭐ - · MIT

单头文件库的极致:把 JSON 写成 C++ 原生类型

17.9 万代码行数
503源码文件
19 MB仓库体积
0 / 0QML / .ui 文件
1 周建议投入

为什么值得读

`json j = {{"name", "value"}, {"list", {1, 2, 3}}};` —— 这种「像脚本语言一样写 C++」的能力,来自极其克制的模板设计与 operator 重载。它是学习「库 API 该怎么设计」「模板如何不外泄复杂度」的绝佳材料,也是日常工程里最常用的库之一。

核心知识点

模板特化与 ADL迭代器与 STL 兼容异常安全与 strong guaranteeJSON Pointer / Patch用户自定义字面量 _json单头文件发布策略

怎么跑起来

# 直接把 single_include 加入 include path
# 跑测试
cmake -B build -DJSON_BuildTests=ON
依赖:header-only;测试需要 CMake 自动拉取依赖
本地路径:QtCpp-Projects/code/json

源码导读(按这个顺序看)

  • single_include/nlohmann/json.hpp发布产物,先整体浏览类结构
  • include/nlohmann/detail/input/lexer.hpp词法分析:状态机怎么写
  • include/nlohmann/detail/input/parser.hpp递归下降解析与错误定位
  • include/nlohmann/detail/output/serializer.hpp序列化与转义处理
  • include/nlohmann/json.hppbasic_json 的类型系统与 STL 互操作
  • docs/mkdocs/docs/features/设计文档:为什么这样设计 API
难度
进阶 建议第 3 个读
09

Dear ImGui C++ 基础库 GUI 范式对比

ocornut/imgui · ⭐ - · MIT

五个 cpp 文件实现的即时模式 GUI,Qt 的最佳对照面

10.4 万代码行数
103源码文件
7 MB仓库体积
0 / 0QML / .ui 文件
1 周建议投入

为什么值得读

学完 Qt 再看 ImGui,你会真正理解「保留模式」与「即时模式」的区别:Qt 维护一棵控件树,ImGui 每帧重建整个界面。它只有五个核心源文件,却能做出复杂的编辑器界面(游戏行业几乎人手一个)。读懂它,你对 UI 框架的理解会升一个维度。

核心知识点

即时模式 GUI 范式UI 状态与 ID 栈绘制列表与批处理平台/渲染后端解耦字体图集与 DPI 适配无 STL 依赖的容器实现

怎么跑起来

# 无官方 CMake:直接编译
# imgui.cpp imgui_draw.cpp imgui_widgets.cpp imgui_tables.cpp
# + backends/imgui_impl_glfw.cpp + imgui_impl_opengl3.cpp
依赖:GLFW(示例用);核心库零依赖
本地路径:QtCpp-Projects/code/imgui

源码导读(按这个顺序看)

  • imgui.cpp上下文、窗口栈、布局、输入状态机
  • imgui_draw.cpp绘制列表、顶点缓冲、字体图集
  • imgui_widgets.cpp控件实现:按钮、滑块、树、表格
  • imgui_demo.cpp所有特性的活文档,运行后逐项点开
  • backends/imgui_impl_glfw.cpp平台后端:输入与窗口事件
  • backends/imgui_impl_opengl3.cpp渲染后端:如何只依赖绘制列表
  • examples/example_glfw_opengl3/最小可运行工程,先跑起来再读
难度
进阶 建议第 6 个读
10

LevelDB C++ 基础库 系统设计

google/leveldb · ⭐ - · BSD-3-Clause

近三万行讲透存储引擎:LSM-Tree 的最小完整实现

2.9 万代码行数
133源码文件
1 MB仓库体积
0 / 0QML / .ui 文件
2 周建议投入

为什么值得读

想从「会写 C++」跨到「会做系统」,读一个存储引擎是最短路径。LevelDB 把 WAL、MemTable(跳表)、SSTable、Compaction、Snapshot、Iterator 全部实现了一遍,还配了官方设计文档;代码风格克制、几乎无外部依赖,是 Google C++ 工程规范的代表作。

核心知识点

LSM-Tree 写放大与读放大跳表实现CRC32 / VarInt 编码零拷贝 Slicepimpl 与接口隔离CMake 静态库与测试

怎么跑起来

cmake -B build -DLEVELDB_BUILD_TESTS=ON -DLEVELDB_BUILD_BENCHMARKS=OFF
cmake --build build
依赖:零第三方依赖,Windows/Linux/macOS 均可直接编译
本地路径:QtCpp-Projects/code/leveldb

源码导读(按这个顺序看)

  • doc/impl.md官方设计文档,先读它再看代码
  • include/leveldb/db.h公开接口:先理解契约,再看实现
  • db/db_impl.cc读写路径、版本管理、Compaction 调度
  • db/write_batch.cc批量写与 WAL 落盘顺序
  • table/block_builder.ccSSTable 块格式与前缀压缩
  • util/comparator.cc比较器抽象与平台层设计
难度
较难 建议第 5 个读
04

开始之前

环境与方法

环境准备(Windows)

  1. Qt 6.8 LTS + Qt Creator,安装时勾选 MSVC 2022 64-bit 套件
  2. Visual Studio 2022 社区版,安装「使用 C++ 的桌面开发」
  3. CMake ≥ 3.21(Qt 安装包自带,注意加入 PATH)
  4. vcpkg:vcpkg install libtorrent openssl boost 解决 qBittorrent 这类重依赖
  5. Git 与 --depth 1 浅克隆,省下 80% 下载量
  6. 调试器用 Qt Creator 自带的 CDB,或在 VS 里「打开文件夹」直接调试 CMake 工程

读源码的五条经验

  • 先接口后实现:include/ 或 *.h 读完再进 .cpp
  • 只跟一条链路:例如「点击开始按钮 → 下载任务创建 → 列表刷新」
  • 善用断点:在信号 emit 处下断点,看它连到哪些槽
  • 看提交历史:git log -p -- 文件 能告诉你代码为什么长这样
  • 先跑测试:有 tests/ 的项目,跑一遍比读十遍文档快