1. 为什么 C 类图关系总在代码里“走样”UML 类图里画六种关系——继承、实现、关联、聚合、组合、依赖看起来只是线条和菱形的区别但落到 C 代码里很多人会卡在同一个地方聚合和组合的代码长得一模一样关联和依赖也经常分不清。我见过不少项目设计图上明明画的是空心菱形聚合代码里却写成了值成员结果对象生命周期被绑死单元测试没法替换依赖改一处崩三处。这篇内容面向需要把设计图转成可编译骨架的 C 开发者。核心目标不是背 UML 定义而是让你拿到一份能直接编译的类声明骨架配合config.toml把工具链配好再用编译和静态检查动作验证“关系有没有写对”。全文会围绕六种关系的代码落地展开每一步都给可复制的命令和配置。先给一个判断标准后面所有代码都围绕它关系看语义代码看生命周期。谁负责 new、谁负责 delete、谁只是“用一下”决定了你该用值、指针、引用还是纯虚接口。TaoToken 在这里的角色是统一 Key/API 通道你不需要在多个工具之间来回切换密钥模型对话、代码补全、静态分析辅助都可以走同一个入口。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。下面先把前置配置做完再进入六种关系的代码骨架。2. TaoToken 前置统一 Key 与 config.toml 骨架2.1 获取 Key 与工具链定位TaoToken 的定位是统一模型调用通道适合把“设计图转代码骨架”这类重复劳动交给模型辅助同时保持 Key 管理集中。你需要先拿到 API Key入口在控制台的 API Keys 页面控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content拿到 Key 之后不要硬编码进源码。下面给一份config.toml骨架放在项目根目录配合环境变量读取。2.2 config.toml 可复制骨架# config.toml —— 项目级工具链配置骨架 [project] name uml-cpp-skeleton std c17 src_dir src include_dir include build_dir build [taotoken] # 不要在这里写真实 Key用环境变量注入 api_base https://taotoken.net/api api_key_env TAOTOKEN_API_KEY model claude-code timeout_seconds 60 [uml] # 类图关系检查开关 check_inheritance true check_composition true check_aggregation true check_dependency true diagram_file docs/class_diagram.puml [build] compiler g flags [-stdc17, -Wall, -Wextra, -Werror]对应的环境变量设置export TAOTOKEN_API_KEY你的Key注意config.toml只放非敏感配置Key 一律走环境变量。这样提交到仓库也不会泄露。2.3 目录结构约定为了让后面的编译验证可复现先固定目录uml-cpp-skeleton/ ├── config.toml ├── include/ │ ├── inheritance.h │ ├── interface.h │ ├── association.h │ ├── aggregation.h │ ├── composition.h │ └── dependency.h ├── src/ │ └── main.cpp └── docs/ └── class_diagram.puml3. 六种类图关系的 C 骨架与可复制配置3.1 继承与实现泛化用 public 继承接口用纯虚继承泛化在 UML 里是空心三角实线代码里就是public继承。实现接口实现是空心三角虚线代码里是继承纯虚基类。// include/inheritance.h #pragma once // 泛化Animal 是基类Dog 是子类 class Animal { public: virtual ~Animal() default; virtual void speak() const 0; // 纯虚同时构成接口实现关系 }; class Dog : public Animal { public: void speak() const override; };// include/interface.h #pragma once // 接口实现IFlyable 只定义行为契约 class IFlyable { public: virtual ~IFlyable() default; virtual void fly() 0; }; class Bird : public IFlyable { public: void fly() override; };判断要点如果基类有数据成员和部分实现是泛化如果基类只有纯虚函数、没有状态是实现。两者代码形式相同语义不同。3.2 关联单向用指针双向要谨慎关联在 UML 里是实线箭头。单向关联表示 A 知道 BB 不知道 A双向关联双方互持指针。// include/association.h #pragma once class Student; // 前向声明减少头文件依赖 class Teacher { public: // 单向关联Teacher 知道 StudentStudent 不知道 Teacher void setStudent(Student* s) { student_ s; } private: Student* student_ nullptr; // 不负责生命周期 }; class Student { public: // 双向关联双方互持指针但都不负责 delete void setTeacher(Teacher* t) { teacher_ t; } private: Teacher* teacher_ nullptr; };注意双向关联容易造成循环依赖和悬空指针。如果两个对象生命周期不一致优先改成单向关联或者用std::weak_ptr。3.3 聚合整体-部分可分离用指针或引用聚合是空心菱形表示“整体-部分”但部分可以独立存在。代码上通常用指针整体不负责部分的销毁。// include/aggregation.h #pragma once #include vector class Car; // 部分类 class ParkingLot { public: // 聚合停车场包含多辆车但车可以独立存在 void addCar(Car* car) { cars_.push_back(car); } void removeCar(Car* car); private: std::vectorCar* cars_; // 只持有指针不 delete };// include/aggregation.h 续 class Car { public: Car() default; };聚合的关键动作ParkingLot析构时不应该delete里面的Car*。你可以用std::vectorCar*或std::vectorstd::reference_wrapperCar。3.4 组合整体-部分同生命周期用值或 unique_ptr组合是实心菱形部分不能脱离整体独立存在。代码上要么用值成员要么用std::unique_ptr由整体负责创建和销毁。// include/composition.h #pragma once #include memory class Engine { public: Engine() default; void start(); }; class Car { public: Car() : engine_(std::make_uniqueEngine()) {} // 组合Car 负责 Engine 的创建与销毁 private: std::unique_ptrEngine engine_; };如果你确定部分不需要多态直接用值成员更简单class Wheel { public: Wheel() default; }; class CarWithValue { private: Wheel wheel_; // 值成员生命周期与 CarWithValue 绑定 };聚合和组合的代码区别就在这里聚合用裸指针且不负责销毁组合用值或unique_ptr且负责销毁。语义上聚合的部分可以换、可以共享组合的部分是专属的。3.5 依赖方法参数或局部变量避免双向依赖依赖是虚线箭头表示“用一下”。代码上表现为方法参数、局部变量、返回值而不是成员变量。// include/dependency.h #pragma once class Hammer { public: void hit(); }; class Carpenter { public: // 依赖Carpenter 在某个方法里用到 Hammer但不是成员 void build(Hammer hammer) { hammer.hit(); } };依赖和关联的区别关联是成员变量关系持久依赖是方法级关系临时。依赖要避免双向否则编译期头文件互相包含会出问题。3.6 六种关系对照表UML 关系图形C 代码形式生命周期归属继承空心三角实线class B : public A基类不负责子类实现空心三角虚线继承纯虚基类接口不负责实现关联实线箭头成员指针/引用双方都不负责聚合空心菱形成员指针不 delete整体不负责部分组合实心菱形值成员或unique_ptr整体负责部分依赖虚线箭头方法参数/局部变量无持久生命周期4. 编译验证与关系检查动作4.1 编译命令与预期结果把上面的头文件放进include/写一个src/main.cpp// src/main.cpp #include inheritance.h #include interface.h #include association.h #include aggregation.h #include composition.h #include dependency.h int main() { Dog dog; dog.speak(); Bird bird; bird.fly(); Teacher teacher; Student student; teacher.setStudent(student); student.setTeacher(teacher); ParkingLot lot; Car car; lot.addCar(car); CarWithValue carWithValue; Carpenter carpenter; Hammer hammer; carpenter.build(hammer); return 0; }编译命令g -stdc17 -Wall -Wextra -Werror -Iinclude src/main.cpp -o build/uml_demo预期结果编译通过无警告。如果出现incomplete type错误说明前向声明用错了地方需要把成员指针改成引用或在 cpp 里包含完整定义。4.2 用编译期检查验证关系组合和聚合的区别可以在编译期用static_assert辅助验证#include type_traits #include composition.h // 验证 Car 的 Engine 成员是 unique_ptr即组合 static_assert( std::is_same_v decltype(std::declvalCar().engine_), std::unique_ptrEngine , Car 与 Engine 应为组合关系 );如果engine_是私有成员可以把断言放在类内部或提供类型别名。这个动作能防止后续重构时把组合误改成聚合。4.3 用 PlantUML 反向核对在docs/class_diagram.puml里写startuml class Animal class Dog Animal |-- Dog class IFlyable class Bird IFlyable |.. Bird class Teacher class Student Teacher -- Student Student -- Teacher class ParkingLot class Car ParkingLot o-- Car class CarWithValue class Wheel CarWithValue *-- Wheel class Carpenter class Hammer Carpenter .. Hammer enduml用 PlantUML 渲染后和你的头文件逐一对照|--对应 public 继承|..对应接口实现--对应关联o--对应聚合*--对应组合..对应依赖。这一步是人工核对但能快速发现“图上是聚合、代码写成组合”的问题。5. 本篇常见错排查5.1 聚合写成值成员导致无法替换现象单元测试里想替换ParkingLot里的Car发现Car是值成员没法注入 mock。排查检查ParkingLot的成员声明。如果是std::vectorCar改成std::vectorCar*或std::vectorstd::reference_wrapperCar。聚合的部分应该允许外部创建和替换。5.2 组合用裸指针导致内存泄漏现象Car析构后Engine没有释放。排查组合关系里整体必须负责部分的销毁。把Engine* engine_改成std::unique_ptrEngine engine_或者直接用值成员。裸指针只适合关联和聚合。5.3 依赖写成成员变量导致头文件循环包含现象Carpenter.h包含Hammer.hHammer.h又包含Carpenter.h编译报include nested too deeply。排查依赖关系不应该出现在成员变量里。把Hammer从成员改成方法参数头文件里用前向声明class Hammer;在 cpp 里再包含完整定义。5.4 双向关联造成悬空指针现象Teacher和Student互相持有指针其中一个先析构另一个访问时崩溃。排查双向关联要明确生命周期。如果一方生命周期更长短的那方用std::weak_ptr或者改成单向关联。设计阶段能单向就不要双向。5.5 继承层次过深导致编译变慢现象改一个基类头文件整个项目重新编译。排查泛化关系如果超过三层考虑用组合替代继承。接口实现尽量用纯虚基类减少数据成员降低头文件依赖。6. 把关系检查接进日常工具链六种关系落到 C 代码里核心就三件事谁持有谁、谁负责销毁、关系是持久还是临时。继承和实现看public继承和纯虚基类关联和聚合看成员指针且不负责销毁组合看值成员或unique_ptr依赖看方法参数。如果你想把“设计图转骨架”和“关系检查”做成日常动作可以在 TaoToken 的统一通道下配置模型对话和编码计划模型对话入口https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Plan 入口https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content长期做 C 编码和 Agent 辅助的走 Coding Plan 更合适只是偶尔验证模型输出用模型对话就够。Key 统一放在环境变量里config.toml只留非敏感配置这样换工具不用换密钥关系检查脚本也能复用同一套配置。