用六边形架构与整洁架构对比是伪命题?

Opus音频编解码的Python实战:从零构建高效音频处理工具 本文详细介绍了如何使用Python进行Opus音频编解码的实战开发。从环境搭建、核心参数解析到完整的编解码工具类实现,涵盖了实时音频流处理、高级特性(如前向纠错)以及性能优化策略,帮助开发者构建高效的音频处理工具,适用于实时通信、物联网等低延迟场景。 阅读详情

最近有几个朋友不约而同地在问我这样的一些问题:

问题1: 六边形架构与整洁架构选哪个更好?
问题2:查资料说六边形架构更适合于中小型项目,而整洁架构更适合用于大型项目是这样吗?

在论述我的观点之前,还是我一贯的风格先说答案:

用 六边形架构与整洁架构 做横向对比就好像用 iPhone17 与 iPhone4 对比一样,你会选哪个?


一个"公认"的观点

观点:很多人认为整洁架构只适合大型项目,而六边形架构更适用于中小型项目。

我也用AI查过这个问题,貌似有些模型却实是给出了这样的选型答案。

这个观点听起来很合理,我也在一些热门的架构书籍中看过这个观点,甚至被广泛接受。但它经得起推敲吗?

质疑一:大小如何界定?

"大项目"和"小项目"的划分没有客观标准。这个批评是成立的,但是却又是【无理取闹】的。

如果非要用一个指标来衡量复杂度,那么port 的数量(接口)是一个最具体也最能反映问题的。我在实践中发现一但 port 增多,六边形架构就越容易出现混乱,很容易出现【找不到Adapter】或者【找错Adapter】的情况。

为了让更多的朋友看懂,本文选用 python 为代码示例

质疑二:六边形架构的双向问题

六边形架构的 port 分为两类:

# 六边形架构的依赖方向
# 入站方向
入站Adapter → 入站Port → Domain

# 出站方向  
Domain ← 出站Port ← 出站Adapter

其实从认知上来说在 Java , C# 这些优秀的面向对象语言之中 六边形架构就是一种鸡肋,用分层架构就足够了。因为 Port 就是接口,Adapter 就是实现,那以 Java 的写法 接口有时可能从文件名看不出,但实现一定是 XXXImpl.java, 而C# 就是返过来如 IRepository -> OrderRepository 不过习惯了就好,这是惯例的知识,所以在这两种语言中去实践六边形会非常的便扭,代码反而很难看。

六边形是两个方向的分离,那就意味着认知负担翻倍。在 Python 这种没有原生接口的语言中,问题就显得更严重:

# ports/inbound/order_service.py
from abc import ABC, abstractmethod

class OrderServicePort(ABC): # 这就相当于 OrderService 的接口定义
    @abstractmethod
    def create_order(self, order_dto: OrderDTO) -> Order:
        pass


# ports/outbound/payment_gateway.py
class PaymentGatewayPort(ABC):
    @abstractmethod
    def charge(self, amount: Decimal) -> PaymentResult:
        pass


# 问题来了:当你看到 Domain 层调用 payment_gateway 时
# 你需要去哪里找 Adapter?
# adapters/outbound/stripe/?adapters/outbound/paypal/?
# 还是 adapters/inbound/ 里有个奇怪的实现?

“找不到 Adapter” 的情况在六边形架构中并不罕见,尤其是项目演进一段时间后。最蛋疼的是,你想用IDE去跳转实现代码,那你得失望了,因为这是一种抽象层级的定义与实现,IDE并【认不出来】你得手工找。当 Adapter 很多的时候每次你都得在 In / Out 两个目录中来回横跳,非常的麻烦,接口越多你越接近地狱。

质疑三:整洁架构的单一方向

整洁架构的依赖规则极其简单:

Frameworks → Interface Adapters → Use Cases → Entities
     ←———————————— 所有依赖指向内层 ————————————←
# 整洁架构的结构
# entities/order.py
@dataclass
class Order:
    id: OrderId
    items: list[OrderItem]
    status: OrderStatus
    
    def total_amount(self) -> Decimal:
        return sum(item.price for item in self.items)


# usecases/create_order.py
class CreateOrderUseCase:
    def __init__(self, order_repo: OrderRepository, payment_gateway: PaymentGateway):
        self.order_repo = order_repo
        self.payment_gateway = payment_gateway
    
    def execute(self, command: CreateOrderCommand) -> Order:
        order = Order.create(command.items)
        self.payment_gateway.charge(order.total_amount())
        self.order_repo.save(order)
        return order


# adapters/payment/stripe_gateway.py
class StripePaymentGateway(PaymentGateway):
    def charge(self, amount: Decimal) -> PaymentResult:
        # Stripe SDK 调用
        pass


# adapters/persistence/sql_order_repo.py
class SqlOrderRepository(OrderRepository):
    def save(self, order: Order) -> None:
        # SQLAlchemy 持久化
        pass

依赖方向永远指向内核。无论项目大小,这个规则不变。这就意味着整洁架构永远不会出现【循环依赖】,有且只有具备单一方向依赖的架构是不会出现【循环依赖】的。

对于 AI 辅助编程,这种确定性极其重要,你的AI是不会写错代码的或者写代码出错的机率大大降低,我们尝试推理一下AI的推理方式:

Prompt: "在整洁架构中,我需要添加一个新的支付方式 PayPal"

AI 的推理路径:
1. PaymentGateway 接口在 usecases 层定义 ✓
2. 新的 PayPalGateway 在 adapters 层实现 ✓
3. 依赖方向:adapters → usecases ✓
4. 不需要修改任何内层代码 ✓

对比六边形架构:

Prompt: "在六边形架构中,我需要添加一个新的支付方式 PayPal"

AI 的推理路径:
1. 这是入站 Port 还是出站 Port?需要判断...
2. 如果是出站 Port,Adapter 放在哪个目录?
3. 需要检查现有的 Port 定义位置...
4. 命名约定是什么?PaymentGatewayPort?PayPalAdapter?

反驳与修正

我遇到最有意思的一些常见问题

反驳一:CRUD 场景呢?

有人会说:“整洁架构对 CRUD 项目来说太重了。”

这个批评是伪需求。

CRUD 场景下讨论架构是【没有意义的】。首先,CURD不是业务操作,是数据操作没有业务性。没有业务复杂度就没有架构问题,只有代码规范问题。把"整洁架构对 CRUD 冗余"当作批评点,本身就是靶子立错了。

# CRUD 场景:直接在 Controller 里操作数据库,完全没问题
@app.route("/users", methods=["POST"])
def create_user():
    user = User(name=request.json["name"])
    db.session.add(user)
    db.session.commit()
    return jsonify(user.to_dict())

这不是"糟糕的架构",这是没有架构。对于纯 CRUD,这就是正确的选择。即使这在这个create_user 中你直接写SQL最多只能是批评代码的人太水了,将SQL侵入代码这种写法都干得出来,充其量是代码太屎,而是不架构有问题。

反驳二:穿层问题

又有人说:“整洁架构的层次多了,会有穿层的诱惑。” (另一种说法叫:【数据透传】)

穿层不是诱惑,是违规。

# 错误示例:Frameworks 层直接调用 Entities 层
@app.route("/orders", methods=["POST"])
def create_order():
    order = Order.create(request.json)  # 跳过了 Use Cases 层
    order_repo.save(order)              # 跳过了 Interface Adapters 层
    return jsonify(order.to_dict())

整洁架构的依赖规则是硬约束,违反就是错的,没有灰色地带。这和六边形架构的"双向依赖"有本质区别——前者是明确的错误,后者是设计本身的复杂性。

其实上面这个示例还漏了一点,那就是DI,如果你的整洁架构没有DI就容易出现上面的种情况,因为你得去构造,整洁架构中的构造只有在起动的装配位置出现,通过DI管理实例,用接口承接实现。这自然是不会出现所谓的 【透传】这么可笑的情况。


第三回合:核心洞察

六边形架构 vs 整洁架构:不是对比,是进化

把六边形架构和整洁架构放在一起"对比选型",本身就是认知错误与【伪命题】。

从历史演进看:

架构年份核心贡献
分层架构早期分离关注点
六边形架构2005提出 Port/Adapter,解耦内外部
整洁架构2012统一依赖方向,消除双向复杂性

【整洁架构是六边形架构的进化版本】,它修复了六边形的双向依赖复杂性。

就像没人会问"应该用 iPhone 15 还是 iPhone 4"一样,所以说,问"用六边形还是整洁架构"也是伪命题。

代码对比:同一个业务场景

# 六边形架构的目录结构
order-service/
├── domain/
│   └── order.py
├── ports/
│   ├── inbound/
│   │   └── order_service.py      # Port
│   └── outbound/
│       └── payment_gateway.py    # Port
└── adapters/
    ├── inbound/
    │   └── rest/
    │       └── order_controller.py  # Adapter for order_service
    └── outbound/
        ├── stripe/
        │   └── stripe_payment.py    # Adapter for payment_gateway
        └── paypal/
            └── paypal_payment.py    # Adapter for payment_gateway


# 整洁架构的目录结构
order-service/
├── entities/
│   └── order.py
├── usecases/
│   ├── create_order.py
│   └── ports/                    # 接口定义在这里
│       ├── order_repository.py
│       └── payment_gateway.py
└── adapters/
    ├── controllers/
    │   └── order_controller.py
    ├── gateways/
    │   ├── stripe_gateway.py
    │   └── paypal_gateway.py
    └── persistence/
        └── sql_order_repo.py

关键区别:

  1. 六边形:Port 分散在 ports/inbound 和 ports/outbound,需要记住两套规则
  2. 整洁:所有接口都在 usecases/ports,依赖方向统一指向 entities

Python 的特殊情况

Python 没有原生接口,只能用 ABC(抽象基类):

# 六边形架构中,你需要区分这是入站 Port 还是出站 Port
class OrderServicePort(ABC):  # 入站
    @abstractmethod
    def create_order(self, dto: OrderDTO) -> Order: ...

class PaymentGatewayPort(ABC):  # 出站
    @abstractmethod
    def charge(self, amount: Decimal) -> PaymentResult: ...

# 从代码本身,你无法区分哪个是入站、哪个是出站
# 只能靠目录结构推断
# 整洁架构中,所有 Port 都在 usecases 层
# 它们的角色是统一的:被外层实现
class OrderRepository(ABC):
    @abstractmethod
    def save(self, order: Order) -> None: ...

class PaymentGateway(ABC):
    @abstractmethod
    def charge(self, amount: Decimal) -> PaymentResult: ...

# 不需要区分方向,只需要知道:外层实现,内层调用

结论

  1. 大小界定是伪命题:用"项目大小"来选择架构没有客观标准,用 port 数量来衡量复杂度反而更具体

  2. 六边形的双向依赖是设计缺陷:入站/出站两个方向增加了认知负担,尤其在动态语言中

  3. 整洁架构是进化,不是替代:它统一了依赖方向,消除了六边形的复杂性,独绝了循环依赖的发生

  4. 对比本身就是错误的:就像比较 iPhone 4 和 iPhone 15,它们不是"选择关系",而是"进化关系"

  5. 对 AI 编程极其友好:单一依赖方向意味着 AI 可以更准确地推理代码结构


附录:依赖方向的可视化

下面这个图是用AI画的

六边形架构:
                    ┌─────────────────┐
                    │   Inbound       │
                    │   Adapter       │
                    └────────┬────────┘
                             │
                             ▼
┌──────────────┐      ┌─────────────┐      ┌──────────────┐
│  Outbound    │◄─────│   Domain    │─────►│  Inbound     │
│  Adapter     │      │             │      │  Port        │
└──────────────┘      └─────────────┘      └──────────────┘
        ▲                    │
        │                    │
        └────────────┬───────┘
                     │
              ┌──────▼──────┐
              │  Outbound   │
              │  Port       │
              └─────────────┘

依赖方向:双向(入站向内,出站向外)


整洁架构:

┌────────────────────────────────────────────────────────┐
│                    Frameworks                          │
│  ┌──────────────────────────────────────────────────┐  │
│  │              Interface Adapters                  │  │
│  │  ┌────────────────────────────────────────────┐  │  │
│  │  │              Use Cases                     │  │  │
│  │  │  ┌──────────────────────────────────────┐  │  │  │
│  │  │  │            Entities                  │  │  │  │
│  │  │  └──────────────────────────────────────┘  │  │  │
│  │  └────────────────────────────────────────────┘  │  │
│  └──────────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────────┘

依赖方向:单向(永远指向内层)

单一方向的价值:

  • 代码审查时检查点明确
  • IDE 依赖分析工具容易验证
  • 新人理解成本低
  • AI 辅助编程推理路径清晰
  • 不会出现循环依赖
  • 模块天然内聚,特别容易从文件名的语义上就发现是否会出现类的“泄漏”或“跳层”
架构设计与微服务:从单体到六边形架构 本文探讨了应用架构设计的重要性和方法,从单体应用程序到微服务架构的不同选择。分析了单体应用的快速开发优势以及分层架构和六边形架构在微服务设计中的应用,并讨论了服务发现机制和服务通信策略。 阅读详情

相关推荐

Infineon MOSFET开关损耗计算实战指南

本文是英飞凌MOSFET开关损耗计算的实战指南。针对MOSFET发热问题,文章深入剖析了开关损耗的产生机理,并基于Infineon数据手册的关键参数,手把手推导了开通与关断损耗的工程计算公式。同时,指南强调了栅极电阻、寄生参数等实际因素对损耗的影响,并提供了从理论计算到实测优化的完整路径,帮助工程师精准评估与优化电源设计。

weixin_29212867的博客 448

六边形架构

六边形架构

weixin_44125071的博客 1148

从零开始掌握OBD-II:汽车诊断开发的核心技术与实战解析

本文深入解析OBD-II汽车诊断系统的核心技术,包括ECU通信协议、故障码解析及诊断工具开发实战。通过详细的协议分析和代码示例,帮助开发者快速掌握汽车诊断开发技能,实现从零到精通的进阶。特别适合从事汽车电子开发和OBD检测的技术人员参考学习。

weixin_42528780的博客 442

六边形架构认识

六边形架构认识 微服务架构基础架构 tags: 六边形架构 架构模式 categories: 架构模式 六边形架构简介 六边形架构由Alistair Cockburn于2005年提出,相较于传统三层架构方式的缺点————不支持多客户端、不支持多数据库、领域层依赖持久层,六边形架构实现了业务逻辑以一种松耦合的形式与多个外部系统通过“适配器-端口”的形式进行集成。某种意义上六边形架构也是一种分层...

Where_dWanaGo的博客 1975

2023年金蝶云星辰初级顾问认证参考试题(1)

最新积累的考试真题,答案只供参考(49分T~T),欢迎大佬们更正,私聊我修改,有新的试题也可以私聊我,日后会完善题库!大家一起努力,预祝大家顺利通过!1.【简单】生产环节中,客户老板希望掌握材料的超发或漏发情况,,以便分析用料情况,对材料浪费进行管控,可以查看什么报表?⒉[中等】客户主营电气柜的生产销售,商品为非标品需定制,又因交期效短,需要边生产边补料,以下哪个功能最适合该客户场景?15.【简单】在给商品设置科目关联时,分别按照单个商品,商品类别,所有商品设置了对应客户,()优先级最高。

MLX00的博客 7980

DANN实战:用Python手把手教你实现对抗迁移学习(附完整代码)

本文通过Python实战教程,手把手教你实现DANN对抗迁移学习模型,以解决领域偏移问题。文章详细解析了领域对抗神经网络的核心机制,包括梯度反转层和领域判别器的构建,并提供了从数据准备、模型搭建到训练评估的完整代码,帮助开发者快速掌握这一强大的无监督领域自适应技术。

net55的博客 318

浅谈六边形架构

定义:六边形架构又称作端口和适配器模式,是一直对称性的架构风格;系统通过适配器的方式与外部交互,将应用服务于领域服务封装在系统内部;也是一种分层架构(主要分为:端口适配器、应用层:定义系统可以完成的工作、领域层:负责表示业务概念、规则与状态) ...

工匠精神coding,终生学习 1046

六边形架构与整洁架构的对比是伪命题?架构演进视角下的深度剖析

回到最初的两个问题,答案已十分清晰:六边形架构与整洁架构无需对比选型,二者是架构思想的演进关系,整洁架构是六边形架构的优化升级版本,解决了其核心设计缺陷;以“项目大小”作为架构选型依据是片面的,真正的选型指标是业务复杂度、端口交互数量、团队工程化能力,而整洁架构的单向依赖规则,能适配从简单到复杂的各类项目场景。软件架构设计的核心,从来不是追求“高大上”的模式名称,而是让架构匹配业务诉求,实现“业务逻辑可独立演进、技术细节可灵活替换”的目标。

sdgfafg_25的博客 406

MIPI信号的分析--结合示波器实际测试波形

如果排查的思路对你有帮助,请记住 消雨匆匆 or 大吊工。码字和排查很累,仅此而已 ,硬件不是抄电路,拿烙铁,懂点软件,细致分析,找问题和破案搜集线索是一样的。 部分内容来自于此博客的大神总结: http://www.elecfans.com/news/wangluo/20170323499614.html http://www.elecfans.com/yuanqijian/jieko...

消雨匆匆 4万+

uniapp+google map不显示

uniapp+renderJS+google map开发安卓版APP非小程序,google map小叉号不显示,google map自定义marker右上角的小叉号如何去掉,uniapp+google map不显示

renkai721的专栏 528

ogg-opus协议解析示例

因为 Port 就是接口,Adapter 就是实现,那以 Java 的写法 接口有时可能从文件名看不出,但实现一定是 XXXImpl.java, 而C# 就是返过来如 IRepository -> OrderRepository 不过习惯了就好,这是惯例的知识,所以在这两种语言中去实践六边形会非常的便扭,代码反而很难看。其实上面这个示例还漏了一点,那就是DI,如果你的整洁架构没有DI就容易出现上面的种情况,因为你得去构造,整洁架构中的构造只有在起动的装配位置出现,通过DI管理实例,用接口承接实现。

2501_94623081的博客 180

【图像去噪】基于梯度为0法实现图像去噪附matlab代码

近几年,徐立提出的 L0 梯度最小化模型在图像平滑领域得到了广泛的应用和发展[11]. 和以往的局部滤波模型不同的是该模型可以全局的估计图像的像素值,因此,L0 梯度最小化模型在处理图像的同时能够很好的保护图像的边缘.​。

qq_59747472的博客 186

你的接口很好,但在使用者眼里,它可能只是个打不开的黑盒

因为 Port 就是接口,Adapter 就是实现,那以 Java 的写法 接口有时可能从文件名看不出,但实现一定是 XXXImpl.java, 而C# 就是返过来如 IRepository -> OrderRepository 不过习惯了就好,这是惯例的知识,所以在这两种语言中去实践六边形会非常的便扭,代码反而很难看。其实上面这个示例还漏了一点,那就是DI,如果你的整洁架构没有DI就容易出现上面的种情况,因为你得去构造,整洁架构中的构造只有在起动的装配位置出现,通过DI管理实例,用接口承接实现。

uRNB99bAJ的博客 474

最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版

Part-E1-SDIO-Specification-Ver4.00-Final-120220.pdf:最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版,包括SDIO 接口的外设,SDIO 接口官方协议等。

锂电池充电器电路设计 里面有电路

锂电池充电器电路设计 里面有电路 3.7V升压到5V电路设计。

[学习笔记]超越超级大循环与原生RTOS:事件驱动架构如何改变嵌入式固件的可扩展性

RTC:事件处理器一旦开始,全部状态迁移、进出动作、输出事件必须全部执行完毕才返回;同一个组件,当前处理没结束,不会开始下一条事件。这不是架构给状态机额外施加的限制,这是UML状态图等全部状态机形式化本身固有的语义要求。如果迁移中途可以被打断,状态机会停留在未定义的中间状态。RTC保证两次事件之间,状态机永远处于明确定义的合法状态,便于分析与测试。

MiKiJT的博客 242

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

源网荷储分层控制架构:从设备级到系统级的协调优化

面对分布式光伏、储能与柔性负荷大规模接入带来的运行复杂性,传统粗放管控模式已难适应高比例新能源场景。源网荷储分层控制架构通过“设备级保安全、台区级调协同、系统级统全局”的多层级协同体系,实现单体精准执行、局部动态平衡与全域优化统筹,构建自上而下指令分解、自下而上反馈闭环的精细化调控新模式,有效破解设备冲突、局部最优与全局失衡难题,推动分布式能源从“各自为战”迈向“协同共赢”,为新型电力系统安全高效运行提供核心支撑。

zhuhai_xigedian的博客 297

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

政务知识库AI架构选型:强合规约束下的架构决策与落地路径

政务知识库是典型的强合规导向场景,架构选型的第一原则是「合规一票否决」:安全优先级高于效果,可控性优先级高于体验,所有技术决策必须先通过等保、密评、信创、数据不出域四大硬性红线校验,再在此基础上优化检索准确率与用户体验。对应部署在互联网政务服务域、政务外网办公域、涉密内网核心域,三域物理隔离,数据仅能通过审批流程单向摆渡,禁止跨网调用模型与流转数据。• 放弃通用文档加载器,基于公文格式标准开发定制化结构化解析器,自动提取文号、标题、发文机关、成文日期、生效日期、密级、主题词等元数据,与分片内容绑定入库。

2401_89363342的博客 378
上一篇: 老兵不死,只是换了战场:从27年的企业开发转型AI应用开发
下一篇: AI基于Spec开发是巨坑?
Ray-Liang
博客等级 码龄25年 31粉丝 12原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值