内容主线里程碑:卷三「标准库」容器篇完工、迭代器篇起步,卷八「嵌入式」做了一次系统性的内容刷新与归属重组,卷十新增两个 CppCon 2025 笔记系列;平台层完成了站点视觉重做与 Agent 协作接入,并把学习路线图中英双语重写。
按 v0.5.0 路线图「012 卷三全面重建」继续推进,本轮新增 15 篇正文,覆盖第一部分(容器)完工与第二部分(迭代器)起步:
第一部分「容器与内存」完工(14 篇,均含可运行代码,核心章节附真实终端实测)
- 选型与基础 — 容器选择指南(按操作/内存/失效规则挑容器)、
std::array、std::initializer_list、对象大小/对齐/平凡类型 - 顺序容器深入 —
vector(三指针/扩容/迭代器失效)、string(SSO/COW/resize_and_overwrite)、deque/list/forward_list - 关联容器 —
map/set(红黑树/异构查找/节点句柄)、unordered_map/unordered_set(哈希表/桶/自定义 hash) - 视图与适配器 —
std::span、容器适配器(stack/queue/priority_queue 的包装机制) - 新标准容器 —
flat_map、inplace_vector、mdspan(按 C++23/26 编译器支持度标注) - 内存 — 自定义分配器与 PMR
- 字符与编码 —
char8_t与 UTF-8 字符串
第二部分「迭代器/算法」起步(1 篇)
- 迭代器基础与 category:容器和算法靠什么对接
同时执行了 v0.5.0 规划的归属迁移:把 type-safe register、circular buffer、intrusive containers 三篇非标准库内容迁出至卷八,让卷三回归「标准库」本位。卷三第二部分余下文章(STL 算法、ranges 进阶等)与第三部分(通用设施/libc++ 源码阅读)仍待后续推进。
嵌入式卷在 v0.5.0 已有完整骨架(环境搭建、LED、Button、UART 整条 hands-on 链),本轮做的是系统性内容刷新 + 归属重组,而非从零起步:
- 对环境搭建、LED、Button、UART 等章节做了内容修订与统一
- 接收卷三迁入的 type-safe register / circular buffer / intrusive containers 三篇
- 把 Empty Base Optimization 迁出至卷四(归属更贴「高级主题」)
- 新增各章节 landing 索引页,删除已过时的
array-vs-raw-arrays
新增两个 Back to Basics 系列(各 3 篇正文 + 导读):
- Back to Basics: Ranges — 从循环到迭代器、STL 算法与迭代器陷阱、ranges views 与组合
- Back to Basics: Move Semantics — 拷贝代价与动机、值类别与引用、移动操作/
std::move/拷贝消除
从卷八迁入 Empty Base Optimization 一文(归属调整)。
让仓库对 AI 编程助手(Claude Code 等)开箱即用,建立跨 agent 的统一入口与协作约定:
- 新增 AGENTS.md 跨 agent 入口与 CLAUDE.md,沉淀项目级指令
- 开放
.claude/协作设施:patch/minor/new-article/audit/preflight/verify-claim/explain等命令、写作风格与文档 frontmatter 规则、文章事实核查与严谨度审查 prompt、bare-python 拦截钩子 - 新增
.github/faq.md与.github/learning-with-agents.md,面向读者与贡献者说明如何借助 agent 学习与协作
首页与内容呈现层做了一次成体系的视觉刷新:
- 新增
HomeHeroVisual、HomeRoadmap首页可视化组件 - 新增
ProofStrip(实验证据条)、ScreenshotCarousel(截图轮播)组件 - 重做
OnlineCompilerDemo在线编译演示 - 引入 shiki 语法高亮、新增 build-info 注入
- 配套移动端阅读修复与整体样式调整
- 优化了一下顶部栏,嗯,看着不拥挤了!
中英双语重写 documents/roadmap/index.md,按稳定信号(主题/难度/前置/平台/成熟度)组织,不堆砌篇数与统计。
新增社区/dev 迭代节奏文档与社区入口页,沉淀 patch/minor 迭代约定。
- filesystem 代码示例细节修正(#45,@YukunJ)
- 修复 filesystem 原子操作章节的错误注释(#46,@YukunJ)
- 同步本版本全部中文内容变更至英文,并对多个卷的英文文档做了批量同步校对
Charliechen114514、YukunJ
| 指标 | 数量 |
|---|---|
| 文件变更 | 834 files(+30,566 / -19,870) |
| 提交数 | 15 |
| 合并 PR | #45–#64(共 12 个) |
| 贡献者 | Charliechen114514、YukunJ |