命名
不同的开发者有不同的经验和上下文,当相同的实体被不同地命名时,这可能导致团队中的误解。例如:
- 用于显示的组件可以被称为 "ui"、"components"、"ui-kit"、"views"…
- 在整个应用程序中重用的代码可以被称为 "core"、"shared"、"app"…
- 业务逻辑代码可以被称为 "store"、"model"、"state"…
Feature-Sliced Design 中的命名
该方法论使用特定的术语,例如:
- "app"、"process"、"page"、"feature"、"entity"、"shared" 作为 layer 名称,
- "ui"、"model"、"lib"、"api"、"config" 作为 segment 名称。
坚持使用这些术语非常重要,以防止团队成员和加入项目的新开发者之间的混淆。使用标准名称也有助于向社区寻求帮助。
命名冲突
当 FSD 方法论中使用的术语与业务中使用的术语重叠时,可能发生命名冲突:
FSD#process
vs 应用程序中的模拟进程,FSD#page
vs 日志页面,FSD#model
vs 汽车型号。
例如,开发者在代码中看到 "process" 这个词时,会花费额外的时间试图弄清楚指的是哪个进程。这样的冲突可能会破坏开发过程。
当项目术语表包含 FSD 特有的术语时,在与团队和技术不相关的各方讨论这些术语时要格外小心。
为了与团队有效沟通,建议使用缩写 "FSD" 作为方法论术语的前缀。例如,在谈论进程时,您可能会说:"我们可以将这个进程放在 FSD features layer 上。"
相反,在与非技术利益相关者沟通时,最好限制使用 FSD 术语,并避免提及代码库的内部结构。