目录 (15)
不使用FSD架构的原因及替代方案
您了解 FSD(功能切片设计)架构吗?它是一种专为前端设计的可扩展架构。其关键在于围绕功能构建项目。以往的架构通常基于技术进行划分,例如组件、API、样式和服务,而 FSD 则基于业务逻辑和用户功能进行划分。
FSD架构
FSD 架构由多个层组成,每个层分为六个以功能为中心的层,每个层有多个切片,每个切片有多个段。

层级:根据应用程序所扮演的角色和职责进行分类。它由如下所示的 6 个层级组成。(此层级可调整,并可应用不同的标准。)
app:应用程序初始化、提供程序、路由器
页面:基于 URL 的屏幕
小部件:构成页面的大型 UI 块(包含多个功能),通常由页面内的可重用单元组成。
功能:用户执行的操作(例如,登录等)
实体:核心领域对象(用户、产品)
共享:不属于特定域的可重用代码,不存在切片或段。
切片:基于业务领域
用户
邮政
...
部门:技术部
用户界面
API
模型
...
FSD架构依赖规则
FSD架构规定,下层不能使用上层。此外,除共享层外,同类型层之间不允许交叉导入。在允许交叉导入的情况下,会通过在文件夹名称后添加“@x”来使用例外规则,以便调用层能够识别出正在进行交叉导入。

FSD架构文件夹结构示例
现在,为了帮助您理解,我将向您展示 FSD 架构文件夹结构的示例。
src/├── app/ # 应用初始化、提供程序、路由│ └── providers/│├── pages/ # 基于路由的页面组合│ ├── login/│ └── cart/│├── widgets/ # 独立运行的 UI 模块│ └── header/│├── features/ # 用户行为(场景)单元│ ├── auth/ # 登录│ │ ├── ui/│ │ │ └── LoginForm.tsx│ │ ├── model/│ │ │ └── useLogin.ts│ │ └── index.ts # 公共 API(仅在此处对外公开)│ └── add-to-cart/ # 放入购物车│ ├── ui/│ │ └── AddToCartButton.tsx│ ├── model/│ │ └── useAddToCart.ts│ └── index.ts│├── entities/ # 业务领域模型│ ├── user/│ │ ├── ui/│ │ │ └── UserAvatar.tsx│ │ ├── model/│ │ │ ├── types.ts│ │ │ └── userStore.ts│ │ ├── api/│ │ │ └── userApi.ts│ │ └── index.ts│ └── product/│ ├── ui/│ │ └── ProductCard.tsx│ ├── model/│ │ └── types.ts│ ├── api/│ │ └── productApi.ts│ └── index.ts│└── shared/ # 未知域的公共代码 ├── ui/ │ └── Button.tsx ├── api/ │ └── apiClient.ts ├── lib/ │ └── formatPrice.ts └── config/ └── env.tsFSD架构评估
我将从五个方面评估FSD架构。
凝聚
耦合
可发现性
心智模型匹配
逐步引入
1. 内聚性
内聚性指的是相关代码之间的紧密程度。如果代码分散,内聚性就低。
因同一原因必须一起修改的代码被视为相关代码,并被认为具有高内聚性。
我认为从内聚性的角度来看,FSD架构并不理想。这是因为,实际上,当你修改一个函数时,有时也需要检查底层代码。

如上所示,凝聚力较低,导致以下问题。
认知负荷:需要打开的文件越多,开发人员需要掌握的上下文信息就越多。
隐藏的依赖关系:修改某一层可能会影响其他层,无论它们是下层还是上层。
代码审查速度慢:审查人员需要检查多个文件夹才能理解单个更改。
入职培训困难:新入职的开发人员无法仅通过查看一个文件夹来理解某个功能的工作原理。
2. 键合
耦合度衡量的是各个模块之间的独立程度。它表明改变一个模块会对其他模块产生多大影响。
如果更改一个模块会影响其他模块并导致它们停止运行,则意味着存在隐藏的依赖关系和高度耦合。

在FSD架构中,由于架构的限制,有些情况下必须打破既定原则,因为某些功能需要相互侵占对方的区域。(参见上图示例,可以看出切片之间的连通性是不可避免的。)
你可能会问,为什么我们不能直接将“添加到购物车”组件合并到 Widget 中,而不是使用上述方法?但这样做实际上会破坏逐层划分的标准,反而使事情变得更加复杂,不是吗?

从上图可以看出,它以矩阵形式展示了基于内聚性和耦合性的依赖关系和内聚性。对于FSD架构而言,其结构本身可能看起来耦合性较低,但在实际应用中,由于其局限性,其耦合性会变得有些模糊不清。因此,我认为它是一种中等耦合性的架构。总之,我认为它处于中等耦合性、低内聚性的境地。
3. 搜索便捷性
如果导航性好,只需查看文件夹结构即可快速找到特定功能或角色的代码。FSD架构在导航性方面存在非常严重的问题。这主要有两个原因。
由于开发者对图层放置位置的不同,导致出现问题——审阅者甚至可能对图层选择本身有异议,从而无法专注于代码。
内聚力低
例如,假设您正在创建一个“搜索栏”组件。开发人员对于应该将此“搜索栏”视为控件、功能还是实体可能持有不同的看法。在这种情况下,如果开发人员 A 创建了“搜索栏”,开发人员 B就无法确定该“搜索栏”位于哪个层级。
4. 心智模型匹配
心智模型表明团队的产品概念和文件夹结构是否一致。
代码结构反映了团队对产品的思考方式。如果代码与团队成员对产品的愿景一致,那么他们在构建或阅读某个功能时,就不需要考虑代码代表架构的哪一部分。

FSD架构根据技术划分层级。然而,实际使用以技术为中心的层级时,由于个人观点各异,无法保证万无一失。因此,需要仔细斟酌。另一方面,如果先根据功能划分层级,在考虑某个功能时,就能更容易地将文件夹结构与自己的想法相匹配。
如果要将心智模型与基于FSD架构各层级的产品概念相匹配,我认为需要大量的共识和培训。我相信这是勉强实现一致性的唯一途径。
事实上,有很多情况下,FSD 架构会被修改和概念化,以符合心理模型。
5. 逐步引入
架构无法在开发初期就最终确定。随着新需求的出现,架构有时必须进行修改。
随着产品演进,架构也会随之改变。因此,架构通常从简单的架构开始,然后逐步调整以适应产品需求。
然而,FSD架构从一开始就需要应用6个层、切片和段。当然,如果你查看FSD官方文档,会找到逐步采用的指南,但我认为实际应用起来非常困难,因为它的结构本身就与现有代码不同。
FSD综合评估
优点
切片层面的凝聚力良好。
不存在循环依赖关系。
劣势
功能层面的凝聚力较差。
选择图层的结果可能会有所不同。
文件夹结构必须以技术为中心。
逐步实施在实际操作中很难实现。
替代建筑方案
我建议采用分层架构和垂直切片作为 FSD 架构的替代方案。
分层架构通常推荐用于中小型项目。与功能结构设计(FSD)类似,它基于技术职责组织代码。在 Web 项目中,通常根据角色划分代码层,例如共享层、表示层、业务逻辑层、数据访问层和路由层。对于后端,则会划分为控制器层、服务层和存储库层。
Web项目分层架构示例
分层架构通常推荐用于中小型项目。与功能结构设计(FSD)类似,它基于技术职责组织代码。在 Web 项目中,通常根据角色划分代码层,例如共享层、表示层、业务逻辑层、数据访问层和路由层。对于后端,则会划分为控制器层、服务层和存储库层。

那么,我们不妨从五个角度对层级架构进行全面评价?
内聚性——内聚性低,因为它没有按功能划分。
耦合度——因团队或项目而异
易发现性——结构简单,易于浏览。
心智模型匹配 - 从技术上讲,通过分割结构,它与心智模型不匹配。
逐步采用——轻松入门
将分层架构 + 垂直切片应用于 Web 项目
垂直切片是基于功能而非技术来划分架构的。通常,你可以把它理解为当分层架构中的单个功能变得过大时,就开始将其拆分成多个垂直切片。

内聚性 - 高,因为单个函数的代码位于单个文件夹中。
耦合度——因团队/项目而异
可发现性——单个函数的全部代码都位于一个文件夹中。
心智模型一致性——业务职能和文件夹轻松匹配
逐步推出 - 通过单个功能文件夹轻松入门
结论
FSD架构虽然具有一些优势,例如能够解决循环依赖问题,并由于其清晰的规则而在切片级别实现良好的内聚性,但它也存在一些问题,例如层次结构选择困难、功能内聚性低以及难以进行增量式部署。因此,在实践中,人们通常会对FSD架构进行修改和重新定义,而不是直接使用原有架构。
我公司也使用FSD架构,但说实话,我不喜欢它。它似乎只会增加沟通成本,并导致我们在决定将功能放在哪一层时需要花费更多时间。然而,如果我们不沟通,事情就必然会处于一种模糊不清的状态。此外,现在要找到访问特定功能所需的文件夹也变得更加困难。
因此,在这种情况下,我认为在分层架构中使用特征切片按域划分会更加灵活。
此外,我还计划在下一篇文章中介绍微前端架构(MFA)。随着团队规模的逐渐扩大,可能会出现需要对所有工作进行划分的情况,包括部署和代码管理,对吧?因此,我将从更高的层面探讨这些职责划分的方法。
