🔧 From syntax to siliconGo beyond desktop C++ — hands-on STM32F1 embedded: register access, interrupt safety, zero-overhead abstraction, cross-compilation & linker scripts. |
- ⚡ Real, runnable examplesCMake projects validated in CI — not unbuildable snippets stranded in articles. |
+ 🧪 Crash LabDeliberately broken crash.cpp, the repaired fixed.cpp, and a step-by-step debugging trail — watch it crash, then corner the culprit. |
- 📚 One complete path10 volumes, 430+ articles — fundamentals → modern features → standard library → advanced → concurrency → performance → engineering → domains. |
- 🚀 C++23 currentCovers and practices concepts, coroutines, ranges and more — not stuck at C++11. |
+ 💻 No board? Blink it anywayRenode is the main verification environment: one command runs your first firmware on a virtual Blue Pill, register sampling proving the LED really blinks. |
+ 📇 C++ feature reference cardsOne card per feature, C++98 through C++23 — grab the syntax you forgot without digging back through a whole chapter. |
🔍 Read real code, real talksVol.9 studies Chromium (e.g. OnceCallback); Vol.10 is reading notes on CppCon and other talks. |
- 🌐 Engineered + bilingualVitePress (search / dark mode / GitHub Pages auto-deploy) + Chinese main line + English translation + C++98→23 reference cards. |
+ 🌐 Engineered + bilingualVitePress (search / dark mode / GitHub Pages auto-deploy) + Chinese main line + English translation. |
@@ -94,23 +94,23 @@ The visual roadmap (ten-volume content map + learning paths by background) is in
### Volume overview
-Core volumes are complete, advanced ones are still being filled in — progress in the open (counts are a snapshot and change as content grows):
-
-| Volume | Topic | Articles | Maturity |
-|--------|-------|:--------:|----------|
-| Vol 1 | Fundamentals (incl. C crash-course) | 87 | ✅ Complete |
-| Vol 2 | Modern features (RAII / smart pointers / move / lambda) | 44 | ✅ Complete |
-| Vol 3 | Standard library in depth | 40 | ✅ Complete |
-| Vol 4 | Advanced (concepts / coroutines / templates / design patterns) | 29 | 🔨 In progress |
-| Vol 5 | Concurrency | 44 | ✅ Complete |
-| Vol 6 | Performance | 38 | ✅ Complete |
-| Vol 7 | Engineering (CMake / toolchain / debugging) | 8 | 🔨 In progress |
-| Vol 8 | Domains (embedded / networking / GUI / storage) | 75 | ✅ Complete |
-| Vol 9 | Open-source code study (Chromium etc.) | 55 | 📚 Ongoing |
-| Vol 10 | Talk & course notes (CppCon etc.) | 17 | 📚 Ongoing |
-
-> Plus "Compilation & Linking" (11) and C++ feature reference cards (46). Most core volumes are complete; the rest are being filled in.
-
+Core volumes are complete, advanced ones are still being filled in — progress in the open:
+
+| Volume | Topic | Maturity |
+|--------|-------|----------|
+| Vol 1 | Fundamentals (incl. C crash-course) | ✅ Complete |
+| Vol 2 | Modern features (RAII / smart pointers / move / lambda) | ✅ Complete |
+| Vol 3 | Standard library in depth | ✅ Complete |
+| Vol 4 | Advanced (concepts / coroutines / templates / design patterns) | 🔨 In progress |
+| Vol 5 | Concurrency | ✅ Complete |
+| Vol 6 | Performance | ✅ Complete |
+| Vol 7 | Engineering (CMake / toolchain / debugging) | 🔨 In progress |
+| Vol 8 | Domains (embedded / TinyML / networking) | 🔨 In progress |
+| Vol 9 | Open-source code study (Chromium etc.) | 📚 Ongoing |
+| Vol 10 | Talk & course notes (CppCon etc.) | 📚 Ongoing |
+
+> Plus Getting Started, the "Compilation & Linking" series, Crash Lab, community articles, and C++ feature reference cards.
+>
> 📋 For volume content and progress see the [project roadmap](todo/000-project-roadmap.md); for release history see [changelogs/](changelogs/).
## Local Development and Checks
diff --git a/README.md b/README.md
index 781064bbb..45dd3cfa5 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
[English](README.en.md) | 中文
-> 一套面向工程实践的现代 C++ 系统教程：从 C/C++ 基础、现代语言特性，到并发、性能、工程化、嵌入式实战与开源项目研读。
+> 一个持续建设的，面向工程实践的现代 C++ 系统教程：从 C/C++ 基础、到现代C++语言特性，再到标准库、并发、性能、工程化、领域应用与开源项目研读。持续的进步中！
> 试一试点一下下面的图片？
🔧 从语法到芯片深入 STM32F1 嵌入式——寄存器访问、中断安全、零开销抽象、交叉编译与链接脚本，打通裸机。 |
- ⚡ 克隆即跑的真示例代码以 CMake 工程组织、CI 构建验证，不是文章里跑不起来的伪代码片段。 |
+ 🧪 崩溃实验室故意写崩的代码、修好的版本、一步步排查的实录——空指针、释放后使用，先崩给您看，再带您破案。 |
- 📚 一条完整路径10 卷 430+ 篇，基础→现代特性→标准库→高级→并发→性能→工程→领域，层层递进、不碎片。 |
- 🚀 紧跟 C++23讲解并实践 concepts、协程、ranges 等新特性，不停在 C++11。 |
+ 💻 不买板子，先点灯嵌入式线以 Renode 模拟器为主验证环境：一条命令让固件在虚拟 Blue Pill 上跑起来，寄存器采样证明 LED 真的在闪。 |
+ 📇 C++ 特性参考卡C++98→23 一特性一卡，忘了语法随手查，不用翻回整章教程。 |
🔍 读真源码 · 读真会议卷九研读 Chromium（如 OnceCallback），卷十是 CppCon 等会议演讲的读书笔记。 |
- 🌐 工程化 + 双语VitePress（搜索 / 暗色 / GitHub Pages 自动部署）+ 中文主线 + 英文翻译 + C++98→23 特性参考卡。 |
+ 🌐 工程化 + 双语VitePress（搜索 / 暗色 / GitHub Pages 自动部署）+ 中文主线 + 英文翻译。 |
@@ -60,9 +64,6 @@
最快的方式是直接阅读在线文档：
- [在线文档站](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/)
-- [C++ 特性参考卡](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/cpp-reference/)
-- [嵌入式开发专题](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/vol8-domains/embedded/)
-- [社区文章](https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/community/)
本地预览文档站：
@@ -73,11 +74,13 @@ cd Tutorial_AwesomeModernCPP
pnpm install
pnpm dev
# 访问 http://localhost:5173/Tutorial_AwesomeModernCPP/
+# 如果你是在WSL中，可能需要pnpm dev --host！
```
生产构建与预览：
```bash
+# 如果您的CPU核心大于4，我们推介加速构建，默认的构建脚本是为CI服务的，Github分配的机器有点小qaq
BUILD_CONCURRENCY=8 pnpm build
pnpm preview
# 访问 http://localhost:4173/Tutorial_AwesomeModernCPP/
@@ -97,23 +100,23 @@ cmake -S code/examples/chapter05/06_array_vs_stdarray -B build && cmake --build
### 各卷一览
-主线卷已成型，进阶卷持续补充——不藏进度（篇数为快照，随更新变化）：
-
-| 卷 | 主题 | 篇数 | 成熟度 |
-|----|------|:----:|--------|
-| 卷一 | 基础入门（含 C 速通） | 87 | ✅ 成型 |
-| 卷二 | 现代特性（RAII / 智能指针 / 移动 / lambda） | 44 | ✅ 成型 |
-| 卷三 | 标准库深入 | 40 | ✅ 成型 |
-| 卷四 | 高级主题（concepts / 协程 / 模板 / 设计模式） | 29 | 🔨 在建 |
-| 卷五 | 并发编程 | 44 | ✅ 成型 |
-| 卷六 | 性能优化 | 38 | ✅ 成型 |
-| 卷七 | 工程实践（CMake / 工具链 / 调试） | 8 | 🔨 在建 |
-| 卷八 | 领域应用（嵌入式 / GUI / 存储等） | 75 | ✅ 成型 |
-| 卷九 | 开源项目研读（Chromium 等） | 55 | 📚 持续更新 |
-| 卷十 | 课程与演讲笔记（CppCon 等） | 17 | 📚 持续更新 |
-
-> 另含「编译与链接」11 篇、C++ 特性参考卡 46 张。主线已成型的卷占多数，其余在持续补充。
-
+主线卷已成型，进阶卷持续补充——不藏进度：
+
+| 卷 | 主题 | 成熟度 |
+| ---- | --------------------------------------------- | ---------- |
+| 卷一 | 基础入门（含 C 速通） | ✅ 成型 |
+| 卷二 | 现代特性（RAII / 智能指针 / 移动 / lambda） | ✅ 成型 |
+| 卷三 | 标准库深入 | ✅ 成型 |
+| 卷四 | 高级主题（concepts / 协程 / 模板 / 设计模式） | 🔨 在建 |
+| 卷五 | 并发编程 | ✅ 成型 |
+| 卷六 | 性能优化 | ✅ 成型 |
+| 卷七 | 工程实践（CMake / 工具链 / 调试） | 🔨 在建 |
+| 卷八 | 领域应用（嵌入式 / TinyML / 网络等） | 🔨 在建 |
+| 卷九 | 开源项目研读（Chromium 等） | 📚 持续更新 |
+| 卷十 | 课程与演讲笔记（CppCon 等） | 📚 持续更新 |
+
+> 另含新手起步、「编译与链接」专题、崩溃实验室、社区文章与 C++ 特性参考卡。
+>
> 📋 各卷内容与进度见 [项目总路线图](todo/000-project-roadmap.md)，版本变更见 [changelogs/](changelogs/)。
## 本地开发与质量检查
@@ -121,20 +124,20 @@ cmake -S code/examples/chapter05/06_array_vs_stdarray -B build && cmake --build
@@ -36,22 +36,26 @@
