我所理解的 Nuxt 最佳实践
接手一个 Nuxt 页面,我通常从 URL 找路由文件,再从模板找组件,最后看哪一层负责数据。页面在开发时能打开,还要确认服务端首屏读到了什么、客户端接管时状态是否一致,以及部署以后有哪些代码真的会运行。这几个问题看起来都和同一个页面有关,却要到不同的地方找证据。
这组做法以 Nuxt 4 的应用为背景。目录组织从框架约定出发,具体注册名看生成声明,状态和插件时序看真实运行结果,部署则从交给目标宿主的产物开始查。
第一篇《沿着路由组织页面和自动导入》从个人主页 /me 出发,区分路由、页面组件和 composable 的职责,说明不同目录怎样被扫描,以及什么时候应明确写出依赖来源。
第二篇《按请求隔离状态,让客户端接得住首屏》用 Header 的两个 hydration 问题区分页面回写与登录态差异,再说明哪些数据随请求创建,哪些浏览器状态可以在客户端共享。
第三篇《用插件依赖声明启动顺序》沿着 Pinia、通知监听和 WebSocket 建连这条链,说明怎样让插件等待真正需要的前置工作。
第四篇《部署前检查资源与服务端产物》用图片 404 和 Nitro 启动失败追踪两条产物路径,也讨论静态前端和独立 API 部署时各自需要验什么。