02-通用语言与协作-DDD领域驱动设计


title: "02 通用语言与协作"


学习目标

  • 理解通用语言(Ubiquitous Language)的作用:消除"人脑翻译"
  • 能建立最小可用的词汇表,并把它映射到代码命名
  • 知道如何在模型演化时同步更新语言与代码

核心概念

通用语言(Ubiquitous Language)

通用语言是围绕模型建立的共同语言,要求团队在:

  • 讨论、文档、图
  • 代码中的类名、方法名、事件名、命令名

都尽量使用同一套词汇与定义。

课堂讲授:语言不是"写出来",而是"用起来"

学生最容易犯的错误是把通用语言当"术语表文档"。正确做法是:

  • 词汇表是"约定",但真正的落点是命名交流
  • 发现歧义(同名不同义)时,要么拆词,要么划边界(有界上下文)

最小可用词汇表模板

你需要的不多,但必须完整:

text 复制代码
术语:
定义:
边界(属于/不属于):
同义词(允许):
禁用词(避免混用):
反例(常见误解):
代码命名建议(类/方法/字段/事件/命令):
示例句(业务/代码各一句):

示例:把"创建订单"命名为"下单"

很多系统把接口叫 createOrder,但业务更常说"下单/提交订单"。这不是"语言洁癖",而是减少认知负担:

  • 命令:PlaceOrder
  • 事件:OrderPlaced
  • 聚合:Order
  • 用例(应用服务方法):placeOrder(...)

常见误区

  • 一个概念多种叫法:create/submit/place 混用,最终所有人都不确定差异
  • 用技术词代替业务词:把"订单取消"说成"updateStatus(3)"
  • 词汇表不维护:模型变了,语言没变,造成"旧词新义"

课堂练习(可评分)

给定一段业务描述,输出一个 8~12 条的词汇表,并满足:

  • 至少 3 个术语包含"禁用词/同义词"
  • 至少 3 个术语给出"代码命名建议"
  • 至少 2 个术语给出"反例(常见误解)"

自测题

  1. 为什么说通用语言是"模型驱动"的?
  2. "订单取消"和"订单作废"如果在业务上含义不同,你会怎么做?
  3. 词汇表更新后,哪些地方必须同步更新?

延伸阅读

参考资料索引:references.md

相关推荐
Jun6261 分钟前
QT(12)-制作lib库
开发语言·qt
Java面试题总结2 分钟前
C#12 中的 Using Alias
开发语言·windows·c#
加号34 分钟前
【C#】 ASCII 码转字符串技术解析
开发语言·c#
Xzh042316 分钟前
AI Agent 学习路线(Java 后端方向)
java·人工智能·学习
Cloud_Shy61840 分钟前
解读《Effective Python 3rd Edition》:从练气到老魔(第五章 Item 33 - 35)
开发语言·人工智能·笔记·python·学习方法
星恒随风1 小时前
C++ 类和对象入门(五):初始化列表、explicit 和 static 成员详解
开发语言·c++·笔记·学习·状态模式
艾利克斯冰1 小时前
Java 设计模式-行为型模式(更新中)
java·开发语言·设计模式
倒霉蛋小马1 小时前
Java新特性:record关键字
java·开发语言
HavenlonLabs1 小时前
硬件 + SaaS 产品的工程化路径:从系统架构、PCB 设计到工程样机
网络·安全·架构·系统架构·安全架构
折哥的程序人生 · 物流技术专研1 小时前
《Java 100 天进阶之路》第95篇:消息队列基础(RocketMQ/Kafka)(2026版)
java·面试·kafka·rocketmq·java-rocketmq·求职招聘