1 / 4概念
Architecture
响应式解决「一个组件怎么更新」,架构解决「一百个组件怎么不互相纠缠」。判断标准不是会不会装路由,而是能否说清一次页面切换经过哪些守卫、数据在服务端还是客户端取、状态在请求之间是否共享。
1 概念
1.1 一句话定义
应用由四层组成:组件树、路由、状态、服务端层。每层各有边界:组件只处理展示与局部交互,路由负责地址与守卫,状态库负责跨组件数据,服务端层负责首屏与数据获取。
1.2 它解决什么问题
- 地址即状态:刷新、分享、前进后退都能还原页面。
- 关注点分离:把数据获取、权限、布局从组件里抽出来。
- 复用逻辑:组合式函数把有状态的逻辑抽成可测单元。
- 首屏与 SEO:服务端渲染让内容在脚本加载前可见。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
响应式原理、ref 与 computed | Reactivity |
| 组件渲染与 DOM 更新细节 | Reactivity、Browser Environment |
| 构建与产物分割 | Toolchain |
| 接口契约、鉴权服务端实现 | Backend Frameworks |
| 部署与进程管理 | 仓库运维章节 |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 组合式函数 | 以 use 开头、封装有状态逻辑的函数 | 不是组件 |
| Pinia store | 跨组件状态容器 | 不是全局变量 |
| 路由守卫 | 导航前后执行的钩子 | 返回值决定是否继续 |
| 布局 | 多个页面共用的外壳 | 不是组件继承 |
| SSR | 服务端渲染首屏 HTML | 不是静态生成 |
| 水合 | 客户端接管服务端 HTML | 不是重新渲染 |
routeRules | 按路由配置渲染与缓存 | 只在 Nuxt 中 |
| 服务端路由 | 同仓库内的接口 | 不是独立后端 |
2 机制
2.1 心智模型
请求进来先过服务端:匹配路由、取数据、渲染 HTML、序列化状态。客户端拿到 HTML 后水合,接管交互,之后的导航只走客户端。状态要么随请求走(不共享),要么放浏览器(跨请求共享)。
2.2 机制拆解
- 通讯方式:
props下行、emits上行、v-model双向绑定、provide与inject跨层、状态库跨页面。 - 路由:嵌套路由决定布局,
meta携带权限与标题,懒加载把页面拆成独立分块。 - 守卫顺序:全局前置、路由独享、组件内守卫依次执行,任一返回
false或重定向就中断。 - 状态库:
Pinia用defineStore定义,setup写法把ref、computed、函数直接暴露。 - 组合式函数:把「取数据 + 加载态 + 错误 + 取消」打成可复用单元,在组件卸载时清理。
- SSR 流程:服务端创建应用、取数据、渲染字符串、把状态写进 HTML;客户端用同一份状态水合。
- 混合渲染:按路由配置静态生成、服务端渲染或客户端渲染,同一应用里可以并存。
2.3 完整枚举
组件通讯的六种方式:
| 方式 | 方向 | 适用 |
|---|---|---|
props | 父到子 | 展示数据 |
emits | 子到父 | 事件通知 |
v-model | 双向 | 表单控件 |
provide 与 inject | 祖先到后代 | 主题、依赖注入 |
| 状态库 | 任意 | 跨页面共享 |
| 路由参数 | 地址 | 可分享的选中状态 |
一次导航经过的守卫与钩子,顺序固定:
| 顺序 | 钩子 | 用途 |
|---|---|---|
| 1 | 全局 beforeEach | 鉴权、埋点 |
| 2 | 路由 beforeEnter | 路由级校验 |
| 3 | 组件 beforeRouteEnter | 进入前准备 |
| 4 | 全局 beforeResolve | 收尾校验 |
| 5 | 全局 afterEach | 清理、统计 |
| 6 | 组件 beforeRouteUpdate | 参数变化复用组件 |
| 7 | 组件 beforeRouteLeave | 离开确认 |
Nuxt 的四种渲染行为:
| 模式 | 首屏来源 | 适用 |
|---|---|---|
| 客户端渲染 | 浏览器执行脚本 | 后台系统 |
| 服务端渲染 | 每次请求渲染 | 动态内容 |
| 预渲染 | 构建时生成静态 HTML | 文档、营销页 |
| 混合 | 按路由分别配置 | 大部分站点 |
状态归属的六个位置:
| 位置 | 生命周期 | 适用 |
|---|---|---|
组件内 ref | 组件存活期 | 局部交互 |
provide | 提供者存活期 | 组件子树依赖 |
| Pinia | 应用存活期 | 跨页面共享 |
| URL | 地址 | 可分享、可刷新 |
| 服务端缓存 | 请求之间 | 列表与详情 |
| 浏览器存储 | 跨会话 | 偏好设置 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 首屏预算 | 一两秒内可交互 | 受包体积与网络影响 |
| 路由分块 | 每页一个 | 首屏只加载当前页 |
| 水合成本 | 与 DOM 节点数成正比 | 大列表要分页或虚拟滚动 |
| 缓存保留 | 分钟级 | KeepAlive 的 max 要设上限 |
| 守卫耗时 | 毫秒级 | 守卫里不要发请求 |
3 实践
3.1 最小示例
一个 setup 写法的 Pinia store,带派生值与异步动作。示例同时展示 storeToRefs 为什么必要。
import {computed, ref} from 'vue';
import {defineStore} from 'pinia';
export const useCartStore = defineStore('cart', () => {
const items = ref<Array<{sku: string; price: number; qty: number}>>([]);
const loading = ref(false);
const total = computed(() =>
items.value.reduce((sum, item) => sum + item.price * item.qty, 0),
);
async function add(sku: string, price: number) {
loading.value = true;
try {
items.value = [...items.value, {sku, price, qty: 1}];
} finally {
loading.value = false;
}
}
return {items, loading, total, add};
});
const cart = useCartStore();
const {total} = storeToRefs(cart); // 保留响应式
cart.add('sku-1', 1999);
追踪:add 修改 items 的引用,total 的依赖被触发并失效;模板里读 total 时重新计算。直接写 const {total} = cart 会把 total 取成一个普通数字,之后不再更新,这是 storeToRefs 存在的原因。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 定义 store | defineStore('id', () => {...}) | 组合式写法更贴近组件 |
| 解构保留 | storeToRefs(store) | 动作不需要包 |
| 懒加载页面 | component: () => import('./Page.vue') | 按路由分块 |
| 页面标题 | meta: {title} + afterEach | 集中维护 |
| 权限校验 | 全局 beforeEach | 未登录重定向 |
| 数据获取 | useAsyncData 或 useFetch | SSR 与客户端统一 |
| 只读服务端数据 | server/api 路由 | 密钥留在服务端 |
| 缓存子树 | KeepAlive 加 max | 限制实例数 |
| 跳过更新 | v-memo | 大列表滚动优化 |
3.3 标准流程
- 先划路由:页面、布局、嵌套关系、权限点。
- 再定数据归属:哪些随请求走,哪些跨页面共享。
- 把取数逻辑抽成组合式函数,返回数据、加载态、错误与重取。
- 状态库只放跨页面数据,派生值用
computed,不要存副本。 - 守卫只做同步判断,异步校验放服务端。
- 首屏关键内容走服务端渲染,交互密集页面走客户端渲染。
3.4 与相邻技术的组合
- 响应式:store 与组合式函数都是响应式对象,解构要用
toRefs。 - 浏览器:路由用 History API,滚动行为与焦点管理要显式处理。
- 服务端:鉴权与数据校验放在服务端,前端的守卫只是体验优化。
- 工具链:自动导入与组件按需加载减少样板与体积。
- 类型系统:store 的返回类型由
setup函数推断,泛型用于useFetch的数据形状。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 渲染 | SPA / SSR / SSG / 混合 | 首屏、SEO、运维成本 |
| 状态 | 组件 / provide / Pinia | 复用与测试 |
| 取数 | 组件内 / 组合式函数 / 框架数据钩子 | 水合与缓存 |
| 路由 | 静态 / 动态 / 文件式 | 约定与灵活性 |
| 代码分割 | 路由级 / 组件级 | 首屏体积 |
3.6 决策规则
- 内容需要被搜索引擎索引,就用服务端渲染或预渲染。
- 需要登录后的复杂交互,用 SPA 更简单。
- 跨页面共享的数据放 Pinia,页面内数据留在组件。
- 守卫不做网络请求,权限判断以服务端为准。
- 首屏不要加载全量组件库,按需引入。
KeepAlive必须设上限,缓存实例会保留状态与内存。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| Vue 加 Vite | 简单、部署轻 | 首屏与 SEO 弱 | 后台系统 |
| Nuxt SSR | 首屏快、可索引 | 需要服务端 | 内容与电商 |
| Nuxt 预渲染 | 可 CDN | 构建时间长 | 文档站 |
| Pinia | 官方、类型友好 | 约定靠团队 | 跨页面状态 |
| 组合式函数 | 复用、可测 | 需要自建约定 | 数据与交互逻辑 |
3.8 何时不该用
- 不要为三个页面的站点引入完整 SSR 框架。
- 不要把请求逻辑写进路由守卫,会阻塞导航。
- 不要用状态库替代 URL,筛选条件应当可分享。
- 不要在组合式函数外创建全局单例状态,SSR 会跨请求污染。
- 不要给所有页面加
KeepAlive,内存会持续增长。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 用户 A 看到用户 B 的数据 | 模块级单例状态在 SSR 共享 | 状态放进 useState 或每次创建 |
| 水合告警 | 服务端与客户端首帧不同 | 首帧不读时间、随机数、存储 |
| 守卫死循环 | 重定向到自身 | 加路径判断 |
| 组件外调用 store 报错 | Pinia 未安装 | 在应用初始化后调用 |
provide 的值不更新 | 传了普通值 | 传 ref 或 computed |
| 返回页面状态是旧的 | KeepAlive 缓存了实例 | 用 onActivated 刷新 |
| 参数变化页面没刷新 | 复用了组件但没监听 | 监听路由参数或加 key |
| 部署后懒加载 404 | 旧分块被删除 | 保留上一版本产物或捕获重载 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 全局单例存用户数据 | SSR 跨请求泄露 | 请求级状态 |
| 守卫里发请求 | 导航卡顿 | 组件内加载 |
| 所有状态进 Pinia | 耦合、难测 | 就近归属 |
每个页面都 KeepAlive | 内存增长 | 白名单加 max |
在 setup 外读写响应式 | 脱离作用域 | 组合式函数内 |
4.3 可观测信号
首屏可交互时间、水合告警数、路由切换耗时、分块数量与体积、KeepAlive 实例数、守卫平均耗时。
4.4 安全 / 性能 / 一致性边界
- 泄露边界:服务端渲染时不要把密钥或内部字段序列化到页面;请求级状态不得进模块级变量。
- 性能边界:首屏体积与分块策略决定可交互时间;水合成本与节点数成正比。
- 一致边界:服务端与客户端必须用同一份数据渲染,否则水合失败并回退到客户端重建。
- 部署边界:懒加载分块与旧版本产物必须并存一段时间,否则升级瞬间会 404。