Skip to content

M5-10详细设计:Nuxt路由规则与混合渲染边界

这份设计文档说明 M5-10 为什么选择 Nuxt 路由规则与混合渲染场景,以及它将如何接入现有方法库。

设计目标

把 Nuxt 响应策略问题从“配置项怎么写”还原成“页面价值、渲染模式、缓存策略与部署响应方式如何协同”的边界设计问题,并用一篇案例把现代 Nuxt 项目里更稳的组织方式说清楚。

为什么在 M5-10 选 Nuxt路由规则与混合渲染

在当前方法库里,已经补齐了:

  • 页面型案例
  • 基础组件型案例
  • SSR / hydration 运行时边界
  • Nuxt 页面数据获取与渲染边界
  • 状态管理型案例
  • 复杂交互型案例
  • 认证与权限型案例
  • 路由与布局型案例
  • 容错与降级型案例
  • 异步加载型案例
  • Nuxt 运行时边界型案例

下一步最自然补的,就是 Nuxt 路由规则与混合渲染策略这条横向主线。因为它会同时影响:

  • 页面首屏响应方式
  • 缓存命中与内容更新时机
  • 内容页、后台页、交互页的策略差异
  • 数据流和部署响应方式是否真正协同

所以 Nuxt 路由规则与混合渲染是一个非常适合作为 M5-10 的横向扩展线。

本轮案例的复杂度中心

本轮复杂度中心主要有四个:

  • 页面价值模型与渲染策略的映射
  • routeRules 与页面语义的对齐
  • swr / isr / prerender 与内容更新节奏的对齐
  • 页面数据流与响应缓存流的协同设计

与现有框架的映射关系

本轮将重点强化统一框架中的这些步骤:

  • 第二步:找到真正的复杂度中心
  • 第四步:判断状态应该放在页面、组件还是 composable
  • 第六步:显式数据流优先,隐式通信后退
  • 第九步:让页面消费层尽量薄

本轮交付物

本轮预期交付物包括:

  • 新案例:../Nuxt路由规则与混合渲染策略重构.md
  • 新任务拆解:32-M5-10任务拆解-Nuxt路由规则与混合渲染场景.md
  • 新详细设计:33-M5-10详细设计-Nuxt路由规则与混合渲染边界.md
  • 新开发记录:34-开发记录-Nuxt路由规则与混合渲染策略重构.md

设计约束

本轮继续遵循当前项目约束:

  • 不直接修改独立 demo 源码
  • 只提炼核心逻辑与方法进入文档
  • 每轮新增案例都要同步更新入口、导航和总框架

完成后的预期效果

完成后,当前方法库将会同时覆盖:

  • 页面型重构
  • 基础组件型重构
  • 运行时边界型重构
  • 框架场景型重构
  • 状态管理型重构
  • 复杂交互型重构
  • 认证与权限型重构
  • 路由与布局型重构
  • 容错与降级型重构
  • 异步加载型重构
  • Nuxt 运行时边界型重构
  • Nuxt 响应策略型重构

这会让整套方法库从“案例集合”,继续长成一张更完整的 Vue / Nuxt 架构重构地图。

共 20 个模块,1301 篇 Markdown 文档。