分享我的 Next.js 项目结构约定
团队规模上来之后，App Router 的目录约定变得越来越重要。分享一份我们用了一年的结构： 几个硬约定： app/ 下的 page 不写业务逻辑，只组装。 数据访问统一走 lib/db/ .server.ts ，文件名后缀卡边界。 Server Actions 放 featu
#Next.js #TypeScript♥ 850 评论
Posts
社区帖子
像论坛一样发起讨论，适合问题、观点、工具推荐和经验交流。
middleware 里取 user 慢，要不要上 Edge Runtime？
middleware 里要解析登录态，每次都查一次数据库，P95 拖到 80ms。想着迁到 Edge Runtime 上跑会快点，但又怕很多 Node 依赖用不了。 测了下，Edge 上不能直接用 Prisma，得换成 serverless driver 或者干脆只验 JWT。最
#Next.js♥ 920 评论
吐槽 Next.js 的文档：caching 那章真的得重写了
不黑不踩，Next.js 文档整体质量不错，但 caching 那一章真的离谱。不同版本默认值变了三回，文档上写的还是老默认值，新人看了直接踩坑。 最让人崩溃的是 "默认 fetch 会缓存" 这条。Next 14 是默认缓存，14.2 之后某些场景又改成不缓存，到 15 默认全
#Next.js♥ 30 评论
Next.js 还是 Vite + React？说说我的取舍
新项目立项，团队在纠结这个。我倾向 Next.js（SSR/SEO 友好），但同事觉得 Vite + React 更灵活、构建快、心智负担小。 我的判断标准大概是这样： 重 SEO、内容型、有 SSR 需求 → Next.js。 中后台、登录后应用、纯交互 → Vite SPA。
#Next.js #React♥ 100 评论
部署 Next.js 到自建服务器，sharedNodeModules 行得通吗？
几台机器上跑了好几个 Next.js 应用，每个都自带一份 node modules，磁盘和构建时间都顶不住。想试试 shared node modules，但又怕依赖版本冲突。 查了下， output: 'standalone' 模式只会打包运行时真正用到的依赖，体积小很多，但
#Next.js #DevOps♥ 170 评论
standalone 输出模式踩坑记录
用 output: 'standalone' 出来的 .next/standalone 目录，理论上拷到服务器直接 node server.js 就能跑。但实际部署我踩了好几个坑。 public/ 和 .next/static 不会被打进 standalone，得手动拷。 路径都
#Next.js #DevOps♥ 240 评论
React 19 的 use() 真的好用吗？
升级到 React 19 后试了下 use() 这个新 hook，能直接读 Promise，写起来确实比 useEffect + useState 简洁。 但用着用着发现几个问题：同一个 Promise 重复 use 不会复用结果，得自己 memo；错误处理还是要靠 ErrorB
#React #TypeScript♥ 310 评论
React 19 升级后，useEffect 跑了两遍，求助
升级 React 19 后，发现部分 useEffect 莫名其妙跑了两次。一开始以为是 Strict Mode（本来就跑两次），但 prod 构建里也出现了。 最后定位到是用了 React Compiler 之后，有些 effect 被自动 memo 化，依赖收集变了，触发了额
#React♥ 380 评论
Actions + useFormStatus 体验分享
React 19 的 useFormStatus 配合 Server Actions，做表单提交体验非常好。提交按钮的 loading 态一行就搞定： 关键是不用再手动维护 state，组件也更干净。配合 useActionState 拿错误信息，整个表单几乎零样板代码。 唯一不
#React #Next.js♥ 450 评论
useActionState 跟 Server Actions 配起来香不香？
试了下 useActionState ，整体思路很好，但 API 设计有点绕。它要传一个 reducer 风格的函数，返回值是 [state, action, isPending] ，跟传统 hook 习惯不太一样。 pending 是后加的，之前还得自己包一个 transiti
#React #Next.js♥ 520 评论
React Compiler 开了之后，我的 memo 全删了
React Compiler 上 stable 之后，我把项目里所有的 useMemo 、 useCallback 、 React.memo 全删了，编译器自动处理 memoization。代码瞬间清爽了一大截。 实测性能：大部分场景持平或略好，个别列表渲染场景还快了点。但有一个
#React♥ 590 评论
TypeScript 的 satisfies，你们用得多吗？
satisfies 出来一年多了，团队里用的人不多。我自己用得挺爽，尤其在定义配置对象时，既能保证类型安全，又能保留字面量类型。 跟 as 比最大的区别是： satisfies 是 "校验" 而不是 "断言"，类型不符会报错而不是硬转。这点对配置文件、路由表、常量映射特别有用。
#TypeScript♥ 660 评论