解释前端 Feature-Sliced Design(FSD)的层、切片、段、公开 API 与依赖边界。

前端 Feature-Sliced Design

依据 Feature-Sliced Design 官方规范。

FSD 按职责划层,在层内按产品语义划分切片,再按代码用途划分段。切片把一起变化的代码放在同一处,公开 API 让调用方依赖稳定入口。

架构形状

text
<源码根>/
  app/routes/
  pages/product-details/{ui,api}/
  widgets/product-gallery/ui/
  features/add-to-cart/{ui,model}/
  entities/product/{model,ui}/
  shared/{ui,api}/
层职责
app应用入口、路由、全局样式与依赖装配。
pages完整页面或主要路由内容,包含页面专用界面、状态和请求。
widgets独立的大块界面,可供多个页面复用,也可承担页面内的独立区域。
features可复用、具有业务价值的用户操作,例如加入购物车。
entities业务实体及其模型、数据访问或界面表示,例如商品。
shared通用界面组件、API 客户端、配置和基础库。

app 和 shared 直接分段。其余各层先分切片,再分段。常用段包括 ui(界面)、model(状态与规则)、api(外部交互)、lib(辅助库)和 config(配置)。层与段按实际职责使用。processes 已弃用。

依赖边界

  • 层级从高到低为 app → pages → widgets → features → entities → shared。跨切片导入只指向严格更低的层,可跳过中间层。同一切片内部可以互相引用,app 和 shared 各自的段也可在本层内协作。
  • 从切片外部访问时,只使用该切片的公开 API。app 和 shared 的段同样提供公开入口。显式导出调用方需要的内容,切片内部引用直接指向内部模块。
  • 同层切片的组合由更高层负责。实体间确有直接模型关系时,可用 @x 为指定实体提供专用公开入口。例如 entities/product/@x/order 供 entities/order 使用。

页面优先

页面专用的界面、状态和请求留在页面切片。商品详情的专用请求放在 pages/product-details/api。当多个页面复用加入购物车操作时,由 features/add-to-cart 承担该行为。各页面通过公开入口组合它。

与 Feature-first 的区别

Feature-first 通常先按业务能力划分模块,再在模块内部按职责分层。FSD 先定义全局层级,再在各层内按产品语义划分切片,并用层级规则约束跨切片导入。