本系列以 Hical 框架源码为实战案例，系统讲解项目使用的 5 个核心 Boost 库。

本系列与 Hical 框架系列的关系

系列视角目标读者
Hical 框架系列（01-05）框架怎么设计想理解 Hical 架构的人
Boost 学习课程Boost 库怎么用想掌握 Boost 库本身的人

同一段源码（如 TcpServer::acceptLoop()），Blog 讲 “为什么用协程做 accept 循环”，本系列讲 "async_accept + use_awaitable 的 API 语义是什么"。

学习路径

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

课程 1: Boost.System    ← 最基础，error_code 是所有 I/O 操作的返回值
    │
    ▼
课程 2: Boost.Asio      ← 核心 I/O 引擎，依赖 error_code
    │
    ├───────────────┐
    ▼               ▼
课程 3: Boost.Beast 课程 5: Boost.MySQL ← 都构建在 Asio 异步模型之上
    │
    ▼
课程 4: Boost.JSON      ← 数据层，与 HTTP 请求/响应及数据库结果配合

课程概览

#课程核心主题前置依赖预计时长
1Boost.System统一错误码、error_category、跨平台映射C++ 基础1-2 小时
2Boost.Asioio_context、协程、TCP、定时器、多线程模型课程 14-6 小时
3Boost.BeastHTTP 消息模型、Parser、WebSocket、SSL课程 1+23-4 小时
4Boost.JSON值类型体系、解析/序列化、PMR 集成、反射课程 12-3 小时
5Boost.MySQL协程式数据库访问、连接池、PreparedStatement 缓存课程 1+23-5 小时

各课程一句话摘要

  • 课程 1 — Boost.System：理解 error_code + error_category 体系，掌握 I/O 操作的两种错误处理模式（错误码 vs 异常）。
  • 课程 2 — Boost.Asio：从 io_context 出发，掌握 C++20 协程式异步 I/O，学会 TCP 服务器、定时器和多线程模型。
  • 课程 3 — Boost.Beast：在 Asio 之上构建 HTTP/WebSocket 协议层，学会请求解析、响应构建和 WebSocket 消息循环。
  • 课程 4 — Boost.JSON：掌握 JSON 值类型操作、PMR 高性能分配，以及 Hical 反射层如何实现自动序列化。
  • 课程 5 — Boost.MySQL：掌握协程式异步数据库访问、参数化查询防注入、连接池设计，以及 Hical 的 Statement 缓存与数据库中间件。

开发环境准备

编译器要求

编译器推荐版本
GCC14+
Clang20+
MSVC2022

Boost 安装

Linux (apt)：

1

sudo apt install libboost-all-dev

MSYS2 (MINGW64)：

1

pacman -S mingw-w64-x86_64-boost

vcpkg：

1

vcpkg install boost-asio boost-beast boost-json boost-system boost-mysql boost-charconv

编译独立示例

课程中的独立示例仅依赖 Boost（不依赖 Hical），可单文件编译：

1
2
3
4
5

# Linux / MSYS2
g++ -std=c++20 -O2 example.cpp -lboost_system -lpthread -o example

# 带 SSL 的示例
g++ -std=c++20 -O2 ssl_example.cpp -lboost_system -lssl -lcrypto -lpthread -o ssl_example

有兴趣可查看 Hical 框架源码地址：github.com/Hical61/Hical