1. 项目背景与名词解释的定位
1.1 为什么这种系统总是绕不开“名词解释”
“云藏山鹰代数信息系统”这个名字,第一次听的人多半会愣一下。按我的理解,这类系统的本质并不是一个单纯的数学软件,也不是只做符号计算的计算器,而是一套依托高阶代数结构、用于表达和推理的工程框架。既然名字里带“代数信息系统”,它处理的对象就不是普通的数值,而是带有结构关系的数学对象——比如范畴中的对象、态射、函子,甚至更上层的自然变换。
一旦进入这个层次,C++ 框架的抽象深度就完全不一样了。用 C++ 去承载高阶范畴的运算和表达,绕不开模板元编程、类型系统、概念约束、编译期分派这些机制。而这些东西的门槛,往往不是代码量,而是术语量。所以这个系列定位成“名词解释”,我反而觉得是极其务实的做法——先不说怎么实现,你得先让大家明白你嘴里说的“对象”“态射”“单子”“伴随”到底在你的系统里指什么,和数学定义有什么区别,和 C++ 代码里的类、函数模板又有什么关系。
从我个人的经验看,好的框架第一关不是架构,而是术语统一。团队里两个人讨论同一个概念,脑子里浮现的可能分别是数学定义、C++ 实现、业务抽象三层不同的画面,这个项目一定走不远。名词解释系列的价值,就是把这三种画面在文档层面钉死。
1.2 这篇“名词解释2”应该站在什么位置
既然是第二篇,说明前面已经有人用“第一篇”铺垫过基础术语了。从标题里“明明德高阶范畴”这个限定词来看,大概率指的是一个相对严格的代数范畴层,可能在第一篇文章里已经介绍过“对象”“态射”“复合”这些最底层的概念。
到了名词解释2,我觉得重点会落在一批“进阶但是绕不开”的词上:函子、自然变换、幺半群、单位与余单位、伴随函子,可能还有类型层面的“模板模板参数”“依赖类型”之类的工程术语。这些名词在学术语境里各有严格定义,但落到 C++ 框架里,它们的含义其实是被“翻译”过一遍的。你需要解释的,不光是“函子是范畴间保持结构的映射”这个课本定义,更关键的是——在你的框架里,函子对应哪一种类模板的实例化策略?用户从哪个类继承、重写哪个虚函数、提供哪个 trait,才算是定义了一个函子?
这篇博文,或者说这整个系列,真正的目标是完成从“数学定义”到“C++ 声明式接口”的语义映射。本文后面只会取几个典型名词做样例,沿着它们把名词解释的尺度和写法深入拆一遍,方便你组织后续系列的其他章节。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. “高阶范畴”到底在 C++ 框架里意味着什么
2.1 从数学定义到工程约定:术语必须先落地
先亮明我自己的态度:给“代数信息系统”做名词解释,最忌讳的就是把教科书定义抄一遍。教科书里的定义是为了严谨,不是为了让代码跑起来。而这里的读者和用户是谁?是跟你一起写框架、调模板、做二次数次开发的 C++ 开发者。他们需要的不是定义本身,而是这个定义在代码库里如何被表达、约束和调用。
打个比方:你在大学学“群论”,群的定义里有“封闭性、结合律、单位元、逆元”。但如果你是在设计一个密码学库,你谈“群”的时候,想的绝不能只是四个公理,而应该想:我的椭圆曲线点集是哪个类?加法运算走哪个方法?单位元是怎么编码的?如果调用者传进来的参数不满足封闭性,我的框架是在编译期就报错,还是等到运行期抛异常?这些,才是工程意义上的“名词”。
高阶范畴也是一样。范畴论里说“高阶范畴”通常指带有 2-态射、甚至 n-态射的结构,态射本身也是某种对象。但放到 C++ 框架里,我不会一上来让大家去实现完整的 n-范畴结构,因为那是不现实的。更务实的理解是:你的框架在“类型”这一层上额外做了一层抽象的“箭头”概念,让类型之间不仅可以转换(函数),而且这些转换本身也可以被当作参数传来传去、可以组合、可以比较。这就是 C++ 里用模板表达高阶结构的切入点——类型成了对象,模板成了对象间的态射,模板模板参数则表达了“态射之间的变换”。
所以我在看“云藏山鹰”这个项目文档时,最关心的就是这个落地点:每一个高深数学名词,后面是否跟着至少一个 C++ 概念、类模板、trait、约束或者惯例用法。有,这个框架就活了;没有,名词是名词,框架是框架,两不相干。
2.2 类型系统就是范畴的载体
我经常和朋友说:如果你已经把 C++ 的模板用熟了,其实你已经默默在写范畴论的雏形,只是没有意识到。
struct A {};是对象。A到B的转换函数或者映射 trait,是态射。- 类模板
template<typename T> struct Box;则像一个从类型到类型的函子——你给我一个具体类型int,我返回一个新的类型Box<int>。 - 模板模板参数
template<template<typename> class F>则更有意思,它允许你把整个Box作为参数,传进另一个模板里。这个操作,在抽象层面上已经非常接近“自然变换”的味道了。
从数学到编译器的这个翻译过程,是有惯用“译法”的。当你做名词解释时,不需要自己发明一套与行业习惯冲突的术语系统,那样会让用户更难理解。比如在数学里函子遵守两条公理:保持恒等态射、保持复合。那么在 C++ 里如果要表达函子,你就必须要求:F 作用于恒等函数时,结果仍然是某种意义上的“恒等”,以及 F(g ∘ f) 要和 F(g) ∘ F(f) 等价。不过在 C++ 的运行时函数层面这往往只能靠约定和测试保障,想在编译期完全约束非常困难。而一旦用类型层面的映射来表达函子,这两个公理的约束就自然严格很多,因为类型的复合本身的语义就是确定的。这也是模板元编程做高阶结构比运行时多态更合适的原因之一。
2.3 运行时多态 vs 编译期抽象:C++ 框架的真正分岔路
在解释概念时,一定要先把 C++ 实现高阶结构的两条路线讲清楚,否则后面所有名词都会混沌。
一条是运行时多态路线。定义一个抽象基类,里面放纯虚函数,子类通过继承表达不同的实现。这种方式最直观,但表达范畴结构时非常僵硬:态射的组合通常要靠虚函数调用层层包裹,运行期开销大,而且无法在编译期检查类型关系。比如你想表达“所有满足某接口的类型都可以互相映射”,运行时继承会把类型关系写死,很难做到灵活扩展。
另一条是编译期抽象路线。核心工具是类模板、特化、if constexpr、concept、requires 表达式。这套机制的重心是把类型当作一等公民,在编译期完成所有结构推导。它的抽象能力比运行时多态高出一整个维度,恰恰是因为它允许模板参数不只是一个类型,而是“一段结构”。
以我的实践经验来看,代数信息系统只要涉及“高阶”两个字,最终基本都会滑向模板元编程方向。原因很简单:系统要的不是快一点点,而是要把类型关系推导清楚,让用户错的时候在编译期就炸出来,而不是运行到一半才崩。这种设计目标直接决定了名词解释里怎么描述一个概念——你需要强调它是“类型层面的运算”还是“运行时的数据流”。这两个世界里的“函子”“自然变换”长得可能很像,但实现原理千差万别。
3. 核心名词逐项拆解(样例级)
3.1 函子:不只是“可 map 的容器”
“函子”大概是继“对象”和“态射”之后最应该被解释清楚的词。在 Haskeller 眼里,函子就是一个带有 fmap 函数的类型构造器;在数学人眼里,函子是范畴之间的保结构映射。但在“云藏山鹰”这类 C++ 代数框架里,我认为它应该被解释成 “一个在类型层面生效的结构映射器”。
举个例子,假设你有一个普通函数 int f(int x),它描述的是整数到整数的映射。函子则负责把整个“整数世界”提升成另一个世界,比如“可空的整数世界”或“整数列表世界”。并且,当你把 f 应用到一个包装好的值上时,函子要能帮你自然地完成这种提升。
在 C++ 里,最朴素的函子表达是:
cpp复制template<typename T>
struct Maybe {
T value;
bool valid;
};
template<typename F, typename T>
auto fmap(F&& f, Maybe<T> const& m) -> Maybe<decltype(f(m.value))> {
if (!m.valid) {
return { {}, false };
}
return { f(m.value), true };
}
在解释这个词时,一定要把“函数提升”这个点讲明白。对于一个普通的容器类,fmap 的核心价值不在于遍历元素,而在于:你在普通世界里写的函数可以原封不动地工作在被包装的世界里,不需要为 Maybe<int> 单独写一个 addOneMaybe。这一点如果讲透了,使用者对框架里很多接口设计的理解会一下子打开。
还有一个常见的混淆点:函子必须先回答“一个类型是一个函子”还是“一个类型构造器是一个函子”。在 C++ 框架里经常会有人写 template<typename T> class Functor 这样的接口,然后让每个容器类去继承它。这种设计从数学上说是错的:函子的作用对象是范畴,而不是具体的类型对象。正确做法是把它表达成一个 trait、一个概念,或者一组重载的 fmap 函数,它的模板参数是那个“类型构造器”。
3.2 自然变换:你其实每天都在写类型转换
自然变换相比函子更难解释,因为在大学课程里它出现得比较晚,而且抽象度比函子高一层。函数子把类型映射到类型,自然变换则把函子映射到函子。
说人话版:假设有两个函子 F 和 G,它们都把你关心的世界提升了一层。自然变换就是一组“无论在什么对象上,都保持一致行为”的转换,把 F 包装的世界切换到 G 包装的世界。
一个经典的例子是:
F= 单值包装Maybe<T>,表示“可能有值”。G= 列表包装std::vector<T>,表示“任意多个值”。
那么从 Maybe 到 vector 的自然变换是:有值就放进只有一个元素的 vector,无值就返回空 vector。可以写成:
cpp复制template<typename T>
std::vector<T> maybeToList(Maybe<T> const& m) {
if (m.valid) {
return { m.value };
}
return {};
}
有什么特别的?这个转换不带任何额外参数,纯粹是“结构之间的映射”。它不能依赖运行时的用户配置,不能依赖对象里的额外状态。函数子像一个集装箱,自然变换像一个标准化的“换箱器”,不管箱子里装的是苹果还是螺丝钉,换箱逻辑都一样。
在 C++ 框架里,自然变换最常见的落点是模板模板参数之间的转换函数。比如你在框架里定义了 Maybe 和 Result 两个效果类型,那么你可能需要一组“效果转换器”,把失败路径与空值路径统一起来。这种转换器往往会在组合子库里大规模出现。名词解释时如果能拿一个真实的代码场景——比如数据库查询库中把 optional 结果换成 expected 结果——来举例,读者会立刻明白它不是数学玄学,而是每天都在处理的工程问题。
3.3 幺半群、单位元与结合律的工程价值
范畴论里幺半群是绕不开的结构,在代数系统中尤其基础。从工程角度理解,幺半群就是一个带有“结合二元运算”和一个“单位元”的集合。听着抽象,但举例子就很直观:
- 整数加法配上元素 0,是幺半群。
- 字符串拼接配上空串,是幺半群。
std::vector的拼接配上空 vector,也是幺半群。
为什么框架要关心这个名词?因为所有可增量聚合、可并行合并、可增量同步的数据结构,底层都依赖幺半群结构。比如在分布式系统里做一个计数器合并,每个节点给的是一个增量,你只要保证合并操作满足结合律、初始值为单位元,就可以任意并行、任意分组合并,不需要按顺序同步。同理,在“云藏山鹰”这种偏数学的系统里,涉及大量把局部结果合成整体结果的场景,用幺半群去抽象是最稳妥的。
在 C++ 里怎么表达幺半群?我通常建议用特性类加自定义概念的组合:
cpp复制template<typename M>
concept Monoid = requires(M const& a, M const& b) {
{ monoid_append(a, b) } -> std::same_as<M>;
{ monoid_identity<M>() } -> std::same_as<M>;
};
然后可以为各种具体类型提供特化或重载。解释这个词时不要光讲结合律公理,要强调它带来的工程红利——不用锁、不用全局顺序、天然支持分治。这是真正让程序员记住这个名词的理由。
3.4 伴随函子与单位/余单位:框架内部设计的高级语法
伴随函子的解释是最棘手的,因为它需要一定的抽象基础。我不建议在名词解释2里铺开得非常正式,但要先把存在感和直觉建立起来。
伴随函子是这么回事:有两个函子 F 和 G,一个从左往右走,一个从右往左走,它们方向相反、关系紧密,满足了某种“互相是对方的最佳近似逆”的关系。真正和工程相关的是它带来的两个辅助态射:单位 η 和余单位 ε。
很常见的落地场景是“自由结构”和“忘却结构”。比如:
F:把一个类型提升为“列表类型”,相当于生成自由幺半群。G:把列表类型的结构丢弃,还原成底层的元素集合类型。
这里的 F 是自由函子,G 是忘却函子,它们就构成一对伴随。单位 η 就是把单个元素放进一个单元素列表。余单位 ε 就是把一个列表折叠成一个单一元素——比如把所有元素求和或者拼接。
在 C++ 框架内部,这种模式常常显式或隐式地出现在序列化、语法树构造、表达式模板这类库里。比如你要搭建一个表达式模板库,把用户写的运算表达式编译成内部语法树,再从语法树求值,定义语法树的类型和求值器类型本质上就是在定义两个函子,中间的转换逻辑就是在构建单位与余单位。
名词解释到这个深度,基本就不需要再往下钻了。因为如果你解释到伴随函子,读者依然跟得上,说明他已经有了很好的抽象感觉。如果跟不上,建议他先回到前面几节消化一下,这也符合框架学习的自然阶梯。
4. C++ 框架层与抽象机制的落地点
4.1 概念约束与 requires:让错误在编译期显形
有了前面这些名词作为词汇基础,可以开始讲实现技术。在 C++20 标准完全可用之前,我们用模板写这种千层饼式的抽象,最怕的其实是“离报错十万八千里”:用户实例化一个模板,报错信息却从三五个层级以外的标准库头文件里喷出来,原因是他没实现某个成员函数。现代 C++ 里改善这一点最有力的工具就是概念。
给名词做解释时,如果这个名词对应某个类型的“能力要求”,应该尽量顺手把它描述成 concept,既能做文档又能做约束。例如前面说的函子的概念可以长这样:
cpp复制template<template<typename> class F>
concept Functor = requires(F<int> fi) {
// 简单检查:在一定类型上 fmap 可调用
};
概念在这里的真正价值不是运行时检查,而是把“用户写错了”的时机从链接期挪到了编译早期,同时把信息说得更清晰。现在框架即便不能在所有角落都加好约束,也至少应该在公共 API 的边界加。名词解释时把这一层讲清楚,比单独讲一百行模板代码更让人受益。
4.2 类型擦除与统一接口:哪个名词适合运行时抽象
前面我说高阶抽象优先做编译期路线,但不要极端化:代数信息系统里也有一部分名词只能在运行时落地。典型场景是插件系统、动态组合运算、规则引擎。比如一个 Expression 基类,任何代数表达式都继承它,再通过虚函数求值,这就属于用“运行时态射”来实现结构抽象。
这种路线的核心实现技巧是类型擦除。你定义的外部接口类型与内部具体类型解耦,调用方只依赖外部接口。典型做法是用 std::function、std::any,或者自己封装一个小型类型擦除类。比如:
cpp复制class AnyExpression {
public:
template<typename T>
AnyExpression(T expr) : self_(std::make_shared<Model<T>>(std::move(expr))) {}
double evaluate() const {
return self_->evaluate();
}
private:
struct Concept {
virtual ~Concept() = default;
virtual double evaluate() const = 0;
};
template<typename T>
struct Model final : Concept {
Model(T expr) : data_(std::move(expr)) {}
double evaluate() const override { return data_.evaluate(); }
T data_;
};
std::shared_ptr<Concept> self_;
};
这个能力在框架设计里至关重要,名词解释时一定会有一批词是描述运行时行为的,比如“求值”“化简”“模式匹配”。对这些词的解释要落到继承关系、虚函数表、类型擦除的包装层上。
4.3 参数推导、分发与 SFINAE:编译期黑话速查
很多名词解释不只是数学概念,还包括 C++ 模板元编程的黑话。既然标题里写的是 “Cpp 框架”,那这套词就不可避免。不然读者看代码,看到 enable_if、void_t、tag dispatch 会一头雾水。
我在解释这类工程名词时一般会组织一套“最小黑话表”:
- 参数推导:编译器根据实参推断模板参数的过程。推导失败不一定是错,可能是为了触发另一组特化。
- SFINAE:全称“替换失败不是错误”。简单说,编译器在做模板匹配时,某个候选模板替换后如果非法,它不会立刻报错,而是把这个候选丢进垃圾桶,继续找别的。这个概念是用来做编译期“重载选择”的基石。
- Tag dispatch:通过一个空标签类型来驱动重载选择,避免用户传错类型。比 SFINAE 可读性好,代价是多写几个 tag 类型。
- if constexpr:在编译期进行分支裁剪,打消“这个模板既要处理整数又要处理类类型”的疑虑。
- 模板模板参数:允许把一个类模板当作另一个模板的参数。前面提到“自然变换的 C++ 落点”主要就是靠它。
每一个名词要想被读者吸收,最好配三段素材:一句话直觉定义、一段最简可编译示例、一个“踩坑”提醒。拿 if constexpr 来说,直觉定义是“代码里的分支在编译时就被决定死”,示例是:
cpp复制template<typename T>
auto stringify(T const& v) {
if constexpr (std::is_arithmetic_v<T>) {
return std::to_string(v);
} else {
return std::string(v);
}
}
踩坑提醒是:if constexpr 分支里的代码仍然需要满足基本语法合法性,比如调用不存在的成员函数仍然可能在模板实例化时报错。这种细节比定义本身更值钱。
4.4 表达式模板与惰性求值:术语库里的重型名词
再往深走,代数信息系统里大概率会碰到“表达式模板”这个名词。它不是数学名词,而是 C++ 特有的一种元编程技术。原理是让运算不立刻产生结果,而是返回一个嵌套的、描述运算过程的类型,最终在显式求值时统一展开计算。
比如简化版向量加法表达式模板的示意:
cpp复制template<typename L, typename R>
struct AddExpr {
L const& l;
R const& r;
};
template<typename L, typename R>
AddExpr<L, R> operator+(L const& l, R const& r) {
return {l, r};
}
实际库会比这个复杂百倍,但核心感觉就是这样:不直接在 operator+ 中开启循环,而是把加法“记录下来”,等真正需要结果时才遍历整棵表达式树。
名词解释里讲表达式模板的价值,不是为了炫技,而是解释框架里为什么有些操作符返回的不是“结果”,而是一个“可继续参与运算的中间结构”。很多用户第一次遇到会莫名惊诧——我加的怎么不是数而是一个怪类型?所以解释这类名词时必须强调一条使用心智:符号表达的是过程,而不是数值。这跟高阶范畴思想其实一脉相承:重视态射关系本身,而不是单纯盯住终点对象。
5. 实体项目里常见问题与排查实录
框架文档写得再完整,实际操作中也不会一帆风顺。我自己在搭建类似 C++ 代数抽象层的过程中,踩过不少典型的坑,这里挑几个高频问题说说解决思路,尤其是那种新用户几乎必问的“编译报错看不懂”问题。
5.1 编译期约束失败:错误信息爆炸怎么查
模板元编程深度一上去,编译器报错动辄上千行。我现在遇到这种情况,第一反应不是去翻完整日志,而是先定位“第一个真正意义上的 error”,通常在几百行里面。很多中间层只是被实例化的结果,源头上是你给模板传的类型,缺少了它要求的成员或概念。
排查步骤我一般这样走:
- 不理会所有
note和candidate行,先找到最后一个带error:的行。 - 顺藤摸瓜找到报错点所在的模板名字,问自己:这个模板期望什么?我给了什么?
- 给关键的模板参数加一个静态断言或概念约束,让报错信息落在你自己写的提示上。
例如我常用 static_assert 加可读性极高的信息:
cpp复制static_assert(Monoid<T>, "T must provide monoid_append and monoid_identity<T>()");
这句话虽然老派,但配合概念使用,至少能把报错的位置从标准库内部拉回业务代码,用户自己也能大致看懂。
5.2 模板特化冲突:当多个重载都匹配时
第二个高频问题是“编译器说我这个调用有多个重载匹配”,但你心里清楚明明只有一个应该匹配。这通常是因为你没有用 if constexpr 或者约束把分支切开,或者特化之间缺乏优先级设计。
解决方案是引入“标签分派”。例如,根据类型是否是一个“基础数学对象”还是“容器对象”,选择不同处理策略:
cpp复制template<typename T>
void process(T const& v) {
process_impl(v, std::is_same_v<T, int> ? int_tag{} : container_tag{});
}
这种做法的可读性和可维护性,比一大堆 enable_if 条件高很多。名词解释里如果有“分派”或者“分发策略”这样的词,就应该用这个案例去说明。
5.3 抽象层过厚导致的运行效率回退
运算结构表达得再优雅,最终还是要落在机器指令上。如果框架设计里大量用虚函数做态射组合、用类型擦除包装所有对象,代码可读性会不错,但性能往往有隐性损耗。对于做代数计算的用户来说,性能问题最后总是会显现。
处理的基本思路是分层:热路径上,尽量使用编译期多态,用模板和概念约束表达结构;冷路径、需要动态扩展的地方才用虚函数和类型擦除。比如一个“表达式化简器”内部有大量模式匹配,它需要的是一个可扩展的访问者接口,这时候虚函数合适;但一个“向量求和”运算如果每层都走虚函数,速度就很难看。讲解名词“抽象层”“访客模式”时,一定要带上这条性能准则。否则用户拿着框架拼装完一个大表达式再去跑,第一次实测性能就会劝退。
5.4 误用自然变换语义,导致运行时状态依赖
第四个坑比较隐蔽:用户把一个根本依赖具体业务状态的转换标成了“自然变换”,结果在配合框架做重组时,发现行为不一致。自然变换的语义约束是它不依赖对象的具体内容,纯结构变换。如果你写转换函数时偷偷读取了一个全局配置、一个环境变量,从数学上它已经破坏了自然性条件,会带来灾难性的隐式耦合。
这一点在代码评审里具体怎么把关?我会习惯性检查所有“结构转换”类函数的签名,如果它不带任何业务参数,那基本是自然的;一旦签名里出现了额外配置参数或者访问了全局状态,在概念归属上就应该改叫“带参数的普通转换”,不能挂在自然变换的名下,误导后续的框架维护者。对术语语义的敬畏,在这种细节上体现得最直接。
6. 名词解释之外的框架演进思考
6.1 构建“术语表-开箱即用最小示例”的双层文档
写名词解释系列时,我坚持一个原则:每个词条必须有“能跑的代码”。读者光看术语表会觉得什么都懂了,真上手开始写还是不知所措。纯定义不提供代码,等于只给了地图没给自行车。
好的词条大致长这样:
- 名称与别名,比如“函子(Functor,类型构造器上的映射)”。
- 一句话直觉:函子是这样一种能力——你给它一个普通函数
A → B,它负责把这个函数安全地送进F<A>里,并且返回F<B>。 - 几行到十几行的最小可编译代码。
- 在框架代码库中的真实文件位置或直接调用示例。
- 常见误解与后果,两三句就够。
我把这些词条形容为“半成品积木”:单个说明是独立的,但组合起来又能拼出整体。若本项目还在早期,先把这个系列的文档骨架搭好,写代码时就有了坐标,越往后期这种边界的价值越大。
6.2 从概念到 concept 的演进路径
结合最近几年的 C++ 生态趋势,框架的高阶抽象会越来越依赖 concept。在名词解释里可以先行孵化一批“概念描述草案”。比如框架如果定义了“幺半群”“函子”“可折叠结构”,后续用 concept 把它们固定下来,比散落各处的文档章节要更有约束力。
演进路径通常是三步:
- 先用注释和文档写清楚名词含义;
- 再在关键模板入口用静态断言做显式检查;
- 最后将检查提炼成 concept,替换掉文档中不够硬的表达。
这套路径对任何抽象库都成立。最怕的是第一步和第二步只留存在某个核心开发者的脑子里,没有形成文本,也没有落到代码约束上,项目进入维护期就会迅速失传。
6.3 对新贡献者的引导建议
系统的门槛问题不只是技术难度,更是术语门槛。我见过不少想参与这种代数 C++ 框架的人,在阅读代码时被 Functor 概念就拦住了。文档越是成体系、名词解释越贴近实现,越能降低贡献者的启动成本。
我建议新加入的贡献者按这样的顺序阅读:
- 先看名词解释中的直觉样例,理解模块想要解决的问题;
- 然后从某一个最小示例开始改代码,把它“搞坏几次”,观察编译报错信息;
- 弄明白报错信息和名词解释中概念的对应关系;
- 尝试为一组相关的名词补充一个示例或者修正一处约束。
这个流程走完,通常两到三个晚上就能从“疑惑状态”进入“能干活状态”。长期做下去,系列文章不只是文档,它已经是框架入门的正式通道之一。
从我个人的实际体会来说,这种“名词解释先行”的文档写作方式,比直接甩架构设计文档有效得多。原因是架构设计讲的是结果,名词解释讲的是代码与语言之间的契约。能把每个名字背后的含义和 C++ 落点解释得清清楚楚,你在框架层面的很多抽象设计错误,都会在落实到文档时提前暴露出来。哪怕后面重写代码,这套名词也能作为稳定的骨架继续存在,不需要推倒重来。
