- Tailwind v4 下，Vue SFC 的 若使用 @apply，必须先 @reference 全局样式入口；否则 sm:* 等 utility 会在该样式上下文里解析失败并导致页面编译报错
- Nuxt 中 useAsyncData / useLazyAsyncData 的 key 不能在“页面关键数据”和“非关键懒加载数据”之间复用；尤其当懒加载侧使用 immediate: false + 空 default 时，客户端导航可能先把共享状态初始化为空，导致业务页错误渲染为无数据。
把“按需使用的压缩依赖”错误地写成了“服务启动必需依赖”，同时还存在第三方库版本用法不匹配的问题。
- 表层现象：线上 Docker 启动时报
Cannot find module 'archiver' - 直接原因：Nitro 启动阶段提前加载了
archiver - 代码根因：
server/utils被自动注入，而相关 util 在顶层静态引入archiver/unzipper - 隐藏次因：FAQ 导出代码对
archiver@8的调用方式不正确 - 环境角色：Docker 不是首因，只是把运行时依赖问题暴露了出来
界面设计
- 懒加载数据的
idle不等于空数据，导航/菜单接口做关联过滤时，必须设计空结果回退策略
界面抖动BUG
核心原因：首屏从“加载态 → 实际内容”切换时，页面高度跨过了视口临界值，导致 Windows 经典滚动条时有时无；而根层没有预留滚动条占位，所以视口宽度瞬间变化，整页发生回流，看起来像“抖一下”。
简要拆开就是：
-
/support/support/manuals首屏存在 异步装载/加载态切换 -
切换前后页面高度不同，有时 不需要滚动条，有时 需要滚动条
-
Windows 下滚动条会占据实际宽度
-
全局根样式没有做 stable scrollbar gutter 预留
-
结果就是：滚动条出现/消失 → 视口宽度变化 → 卡片/文本重新排版 → 页面抖动
所以核心问题不是动画本身，也不是某个组件单独写坏了，本质是“异步首屏高度变化 + 根层未稳定滚动条占位”共同触发的布局回流。