Headless 设计哲学 起步的渐进式学习路线：第一步：理念与环境 → 第二步：四大件 → 随用随查。

Next.js 环境搭建与工具链 起步的渐进式学习路线：第一步：环境与第一批代码 → 第二步：核心机制 → 第三步：数据与状态 → 第四步：全景与升级 → 随用随查。

TanStack 条目式字典（每条含语义、示例、边界与坑）：useQuery、useMutation、乐观更新完整套路、useInfiniteQuery、Table v9 入口与特性组合、columnHelper 列定义、排序交互、Router 路由树、Form v1 无状态等 9 条。

Next.js App Router 条目式字典（每条含语义、多场景示例、边界与坑）：async params、fetch 缓存五档与 revalidateTag、use client 边界与序列化、目录约定、Server Action、Route Handler、next/image、Tailwind v4、proxy、部署形态等 10 条。

内容站要的不是「能跑」，而是「能被找到」。实战：本地 Markdown 起步、generateStaticParams + ISR、metadata 与 OG 动态生成、sitemap/robots 约定文件、三件性能必做、standalone 部署、九项验收清单。

重渲染不等于重画 DOM。讲清四个触发源（state/props/context/父组件带动）、memo 能挡与挡不住什么、浅比较的具体规则、context 粒度设计、渲染日志与 Profiler 两种测法，以及为什么不该过度优化。

React Hooks 难在「以为是调用函数，实际是注册回调」。讲清四件事：函数组件反复执行（所以 useState 初始值只生效一次）、每次渲染的变量是快照（闭包陷阱的根源）、useEffect 是「依赖变化后执行」而非生命周期、useMemo/useCallback 只解决引用稳定不解决性能。

表单同时管理输入值、是否触碰、校验结果与提交状态。显示错误的时机与校验规则是两个决定。

路由把位置变成可保存、可分享的状态。搜索参数来自文本，需要解析与校验，不能因 TypeScript 类型存在就信任地址栏输入。

表格的 data 是原始记录，列定义描述如何读值和渲染。排序、筛选和分页应明确是在当前数据上计算还是由服务端完成。