Vue SFC高内聚低耦合靠职责划分:页面组件管路由与状态协调,业务组件封装领域逻辑,基础组件专注通用展示;用composable抽离逻辑,严格定义props/emits接口,样式与状态均遵循封装原则。

写 Vue 单文件组件(SFC)时,高内聚低耦合不是靠堆技巧,而是靠职责划分清晰、接口定义明确、逻辑边界可控。核心就一点:让组件“自己管好自己的事”,同时“只通过约定好的方式跟别人打交道”。
按三层职责拆分组件结构
不从视觉切块,而从功能归属出发:
-
页面组件(如
UserListPage.vue):只负责路由级布局、数据获取、状态协调。不处理具体渲染逻辑,也不封装业务规则。它调用业务组件,并把 API 响应结果、加载状态、错误信息等作为 props 传下去。 -
业务组件(如
UserTable.vue或OrderFilterPanel.vue):承载领域语义,封装一组相关交互+轻量业务逻辑(比如“点击导出按钮触发下载逻辑”“筛选条件变化后自动刷新表格”)。它依赖明确的 props 输入(如users: User[]、onExport: () => void),不直接调接口、不操作 router、不读取全局 store。 -
基础组件(如
BaseButton.vue、IconLoading.vue):无业务语义,纯展示或通用行为。只接收简单 props(size、type)、发出标准事件(click、update:modelValue),不关心“谁在用它”“用它来干啥”。
用 Composition API 划清逻辑边界
避免把所有逻辑塞进 <script setup></script> 里。复杂业务逻辑要抽成独立的组合函数(composable):
- 把用户列表的请求、分页、搜索、重试封装成
useUserList(),返回{ data, loading, search, refresh }; - 把表单校验逻辑抽成
useFormValidation(schema),与具体 UI 组件解耦; - 组件内部只做“连接器”:导入 composable,把它的返回值暴露给模板,不掺杂额外判断或副作用。
这样既保证组件自身逻辑干净(高内聚),又让业务逻辑可被其他组件复用(低耦合)。
严格定义组件接口,拒绝隐式通信
一个组件对外能“看到什么、能做什么”,必须全部显式声明:
- 用
defineProps明确接收哪些数据,类型必写(支持 TS 推导和 IDE 提示); - 用
defineEmits声明能抛出哪些事件,禁止通过ref暴露方法、禁止用provide/inject跨多层传状态; - 需要定制内容时优先用
,而不是让父组件传一堆 HTML 字符串或 render 函数; - 避免在组件内访问
$parent、$root、getCurrentInstance()等打破封装的 API。
样式与状态也遵循同一原则
内聚不只是 JS 逻辑:
-
是底线,防止样式污染;更进一步,可配合 CSS Modules 或原子类(如 UnoCSS)控制粒度; - 组件内部状态(
ref/reactive)只服务于本组件 UI 行为,不用于存储跨组件共享数据; - 若需共享状态(如当前选中项、全局主题),交由 pinia store 或 provide/inject(限一级父子)管理,组件只订阅、不维护。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










