--- title: "4.9 别再重复造轮子" --- # 4.9 别再重复造轮子 > **本节目标**：掌握 Node.js 生态中最常用的库，学会快速找到合适的轮子，把时间花在业务逻辑上。 小明想给应用加个无限滚动功能，打开 Claude Code 说："帮我写一个无限滚动的实现。" Claude Code 立刻开始写代码。老师傅在旁边看到了，赶紧喊停："等等！你确定要让它写吗？" 小明愣了："AI 能写出来啊，为什么不让它写？" 老师傅说："它确实能写，但那是最低效的方案。如果你用 React，`SWR` 或 `TanStack Query` 已经帮你处理好了无限滚动、缓存、重新验证、错误重试、乐观更新……让 AI 写的话，光处理边界情况就得几百行代码，而且没有经过生产验证。用成熟库更靠谱。" "AI 的价值不是帮你重新发明轮子，"老师傅继续说，"而是帮你找到最合适的轮子，然后教你怎么用。" ## 一个真实项目遇到的问题和解决方案 在开始之前，先看看一个真实的 Next.js 全栈项目在开发过程中遇到了哪些问题，以及用什么库解决的： ### 问题 1：用户数据频繁变化，每次都重新 fetch 太慢 **遇到的问题**：用户列表页面，每次切换回来都要重新加载，体验很差。而且多个组件同时请求同一个接口，浪费带宽。 **解决方案**：`swr` - 自动缓存请求结果，多个组件共享同一份数据，还能自动重新验证保证数据新鲜度。 ### 问题 2：表单验证逻辑散落在各处，改一个地方要改好几个文件 **遇到的问题**：前端验证一遍，后端验证一遍，两边逻辑不一致，经常出 bug。 **解决方案**：`zod` - 定义一次 schema，前后端共用，类型安全，改一处全部生效。 ### 问题 3：用户认证要处理 session、cookie、密码加密……太复杂了 **遇到的问题**：自己写认证系统，光处理安全问题就得几周，还不一定靠谱。 **解决方案**：`better-auth` - 开箱即用的认证方案，支持多种登录方式，安全问题都帮你处理好了。 ### 问题 4：数据库查询写 SQL 太繁琐，还容易出错 **遇到的问题**：手写 SQL 容易拼错，没有类型提示，改表结构要全局搜索修改。 **解决方案**：`drizzle-orm` - 类型安全的 ORM，写查询有智能提示，改表结构编译器会报错。 ### 问题 5：用户上传的内容可能包含恶意脚本 **遇到的问题**：用户输入的 Markdown 或 HTML 可能包含 XSS 攻击代码。 **解决方案**：`sanitize-html` + `rehype-sanitize` - 自动清理危险内容，保留安全的格式。 ### 问题 6：表单状态管理太复杂，每个字段都要写一堆代码 **遇到的问题**：受控组件写起来很繁琐，验证、错误提示、提交状态……代码量爆炸。 **解决方案**：`react-hook-form` - 用 Hook 管理表单，代码量减少 70%，性能还更好。 ### 问题 7：生产环境进程崩溃了没人知道 **遇到的问题**：Node.js 进程挂了，网站就挂了，还得手动重启。 **解决方案**：`pm2` - 自动重启、负载均衡、日志管理，一个命令搞定。 ### 问题 8：日志输出太慢，影响性能 **遇到的问题**：`console.log` 在高并发下会阻塞事件循环。 **解决方案**：`pino` - 异步日志，性能是 `console.log` 的 10 倍以上。 ### 问题 9：拖拽排序功能要处理各种边界情况 **遇到的问题**：拖拽涉及鼠标事件、触摸事件、动画、碰撞检测……自己写至少几百行。 **解决方案**：`@dnd-kit/core` - 专业的拖拽库，可访问性、触摸支持、动画全都有。 ### 问题 10：图片上传前要压缩，否则太大了 **遇到的问题**：用户上传的照片动辄几 MB，服务器带宽扛不住。 **解决方案**：`browser-image-compression` - 浏览器端压缩图片，减少 80% 流量。 --- **看到了吗？**每一个都是为了解决一个具体的问题。没有一个是"为了用而用"，都是"遇到问题 → 找库 → 解决问题"。 这就是现代 Web 开发的常态——**不是你会不会写，而是你知不知道有现成的解决方案**。 ## 为什么不要重复造轮子？ 在 AI 辅助开发时代，很多人有个误区：**"反正 AI 能帮我写，为什么不自己写？"** 真相是： 1. **AI 写的"轮子"质量不如成熟库**： - 成熟库经过几百万次生产验证，AI 写的代码只经过你的测试 - 成熟库有完整的边界情况处理，AI 写的代码可能漏掉 90% 的边界情况 - 成熟库有持续维护和安全更新，AI 写的代码出了问题只能你自己修 2. **维护成本远超你的想象**： - 你以为写完就完了？依赖更新、安全漏洞、新需求……都得你自己处理 - 成熟库有社区帮你解决这些问题，你的代码只有你自己 3. **AI 的真正价值是帮你选库和集成**： - 找到最合适的库 - 读懂库的文档 - 写出正确的集成代码 - 处理特殊场景 ::: tip AI 时代的开发者价值 你的价值不是"会让 AI 写代码"，而是"会选方案、会组装、会解决问题"。让 AI 帮你造轮子是最低效的行为。 ::: ## 如何找到合适的轮子？ ### 1. Awesome 系列（精选列表） Awesome 系列是社区维护的精选资源列表，每个列表都经过严格筛选： - **[awesome-nodejs](https://github.com/sindresorhus/awesome-nodejs)** - Node.js 生态最全面的精选列表 - **[awesome-react](https://github.com/enaqx/awesome-react)** - React 生态 - **[awesome-vue](https://github.com/vuejs/awesome-vue)** - Vue 生态 - **[awesome-python](https://github.com/vinta/awesome-python)** - Python 生态 - **[awesome](https://github.com/sindresorhus/awesome)** - 所有 awesome 列表的入口 ::: tip 快速访问 访问 [node.cool](https://node.cool) 可以直接跳转到 awesome-nodejs ::: ### 2. 其他资源 - **[npm trends](https://npmtrends.com/)** - 对比 npm 包的下载量和趋势 - **[bundlephobia](https://bundlephobia.com/)** - 查看包的体积和依赖 - **[npms.io](https://npms.io/)** - 深度分析包质量的搜索引擎 - **[GitHub Explore](https://github.com/explore)** - 发现热门项目 - **[Libraries.io](https://libraries.io/)** - 跨平台的库搜索引擎 ### 3. 让 AI 帮你选库 这是最高效的方式。把需求告诉 Claude Code，让它帮你筛选： ``` 我需要一个 Node.js 的日期处理库，要求： - 活跃维护（最近 6 个月有更新） - TypeScript 支持 - 文档完善 - 体积小（< 50KB） - 支持时区处理 请推荐 3 个选项，并说明各自的优缺点。 ``` Claude Code 会根据最新的生态情况给你推荐，比你自己搜索快得多。 ## 常用 Node.js 库速查 以下是 Node.js 生态中最常用的库，按分类整理。完整列表请查看 [awesome-nodejs](https://github.com/sindresorhus/awesome-nodejs)。 ### Web 框架 **什么时候需要**：当你需要处理 HTTP 请求、路由、中间件时。如果只是写个简单脚本，Node.js 内置的 `http` 模块就够了。但如果要构建 Web 应用或 API 服务，框架能帮你省掉 90% 的重复代码（路由匹配、请求解析、错误处理、中间件管理……）。 - **[Fastify](https://github.com/fastify/fastify)** - 高性能 Web 框架 **场景**：API 服务，需要高并发处理，性能是 Express 的 2-3 倍 - **[Express](https://github.com/expressjs/express)** - 最流行的 Web 框架 **场景**：通用 Web 应用，生态最完善，找资料最容易，团队协作首选 - **[Hono](https://github.com/honojs/hono)** - 轻量级现代框架 **场景**：需要在 Cloudflare Workers、Deno、Bun 等多运行时部署时 - **[Next.js](https://github.com/vercel/next.js)** - React 全栈框架（教程推荐） **场景**：React 应用，需要 SSR、路由、API 一体化解决方案 - **[Nest](https://github.com/nestjs/nest)** - 企业级框架 **场景**：大型项目，需要依赖注入、模块化架构、完整的工程化方案 - **[Koa](https://github.com/koajs/koa)** - Express 团队的新作品 **场景**：喜欢 async/await 风格，需要更灵活的中间件控制 ### 数据库 ORM/ODM **什么时候需要**：当你需要在代码中操作数据库时。手写 SQL 容易拼错、没有类型提示、改表结构要全局搜索修改。ORM 让你用 TypeScript 写查询，有智能提示，改表结构编译器会报错。 - **[Drizzle](https://github.com/drizzle-team/drizzle-orm)** - 类型安全的 ORM（教程推荐） **遇到的问题**：手写 SQL 容易拼错，没有类型提示，改表结构要全局搜索修改。 **解决方案**：用 TypeScript 定义 schema，查询有智能提示，改表结构编译器会报错。 **为什么不自己写**：类型推导、查询构建器、迁移管理、连接池……自己写的话至少几千行代码。 - **[Prisma](https://github.com/prisma/prisma)** - 功能最全面的 ORM **场景**：需要可视化数据库管理、自动生成类型、完整的迁移工具时 - **[TypeORM](https://github.com/typeorm/typeorm)** - 老牌 ORM **场景**：需要支持多种数据库（MySQL、PostgreSQL、SQLite 等）的传统 ORM - **[Mongoose](https://github.com/Automattic/mongoose)** - MongoDB ODM **场景**：使用 MongoDB 时的首选，提供 schema 验证和查询构建 - **[Sequelize](https://github.com/sequelize/sequelize)** - 多数据库 ORM **场景**：需要在多种 SQL 数据库之间切换时 - **[Knex](https://github.com/knex/knex)** - SQL 查询构建器 **场景**：不想要完整 ORM，只需要类型安全的查询构建时 ### 数据库驱动 **什么时候需要**：当你不想用 ORM，需要直接执行 SQL 时。或者 ORM 底层就是用这些驱动。如果你追求极致性能或需要执行复杂的原生 SQL，直接用驱动更合适。 - **[node-postgres](https://github.com/brianc/node-postgres)** - PostgreSQL 客户端 **场景**：直接操作 PostgreSQL，不需要 ORM 的抽象层 - **[ioredis](https://github.com/luin/ioredis)** - Redis 客户端 **场景**：缓存、会话存储、消息队列，性能和功能都比官方客户端强 - **[mongodb](https://github.com/mongodb/node-mongodb-native)** - MongoDB 驱动 **场景**：不想用 Mongoose，需要更底层的 MongoDB 操作 - **[mysql2](https://github.com/sidorares/node-mysql2)** - MySQL 客户端 **场景**：操作 MySQL/MariaDB，支持 Promise 和 Prepared Statements ### 数据验证 **什么时候需要**：当你需要验证用户输入、API 请求参数、配置文件时。不验证的话，错误数据会导致应用崩溃或安全漏洞。手写验证逻辑散落各处，前后端不一致，改一个字段要改好几个文件。 - **[Zod](https://github.com/colinhacks/zod)** - TypeScript 优先的 schema 验证（教程推荐） **遇到的问题**：前端验证一遍，后端验证一遍，两边逻辑不一致，经常出 bug。改一个字段要改好几个文件。 **解决方案**：定义一次 schema，前后端共用，类型安全，改一处全部生效。 **为什么不自己写**：验证规则、错误消息、类型推导……自己写的话至少几百行代码，还没有类型安全。 - **[Joi](https://github.com/sideway/joi)** - 功能强大的验证库 **场景**：需要复杂验证规则（条件验证、依赖字段）时 - **[Yup](https://github.com/jquense/yup)** - 简单易用的验证库 **场景**：配合 React Hook Form 使用，语法简洁 - **[ajv](https://github.com/ajv-validator/ajv)** - 最快的 JSON Schema 验证器 **场景**：需要验证大量数据，性能是首要考虑时 ### 认证授权 **什么时候需要**：当你需要用户登录、权限管理时。自己写认证系统要处理密码加密、session 管理、cookie 安全、CSRF 防护、OAuth 集成……光处理安全问题就得几周，还不一定靠谱。 - **[Better Auth](https://github.com/better-auth/better-auth)** - 现代认证库（教程推荐） **遇到的问题**：自己写认证系统，光处理安全问题就得几周，还不一定靠谱。密码加密、session、cookie、CSRF……每个都是坑。 **解决方案**：开箱即用的认证方案，支持多种登录方式（邮箱、OAuth、魔法链接），安全问题都帮你处理好了。 **为什么不自己写**：密码哈希、盐值、session 管理、token 刷新、CSRF 防护……自己写的话至少几千行代码，还容易出安全漏洞。 - **[Passport](https://github.com/jaredhanson/passport)** - 老牌认证中间件 **场景**：需要支持 500+ 种登录策略（OAuth、SAML 等）时 - **[Auth.js](https://github.com/nextauthjs/next-auth)** - Next.js 认证方案 **场景**：Next.js 项目，需要快速集成 OAuth 登录 - **[CASL](https://github.com/stalniy/casl)** - 权限管理库 **场景**：需要细粒度的权限控制（RBAC、ABAC）时 - **[node-casbin](https://github.com/casbin/node-casbin)** - 访问控制库 **场景**：需要复杂的访问控制模型（ACL、RBAC、ABAC）时 ### HTTP 客户端 **什么时候需要**：当你需要在服务端调用外部 API 时。Node.js 内置的 `http` 模块太底层，要手动处理请求体、响应解析、错误重试……这些库帮你封装好了。 - **[undici](https://github.com/nodejs/undici)** - Node.js 官方高性能 HTTP 客户端 **场景**：需要极致性能，Node.js 18+ 内置的 `fetch` 就是基于它 - **[axios](https://github.com/axios/axios)** - 最流行的 HTTP 客户端 **场景**：通用 HTTP 请求，拦截器、自动转换、浏览器兼容性好 - **[got](https://github.com/sindresorhus/got)** - 更好的 HTTP 接口 **场景**：需要重试、缓存、钩子等高级功能时 - **[node-fetch](https://github.com/node-fetch/node-fetch)** - Fetch API 实现 **场景**：想在 Node.js 中使用浏览器的 `fetch` API（Node.js 18+ 已内置） ### React 数据获取（重要） ::: tip 为什么需要专门的数据获取库？ 你可能觉得"不就是 `fetch` 吗，为什么要用库？"但实际上，数据获取涉及：缓存、重新验证、错误重试、乐观更新、竞态条件处理、离线支持……自己写的话至少几百行代码，还不一定靠谱。 ::: - **[SWR](https://github.com/vercel/swr)** - Vercel 出品的 React Hooks 数据获取库（教程项目使用） - 自动缓存、重新验证 - 实时更新、乐观更新 - 轻量级（~5KB） - 适合简单场景 - **[TanStack Query](https://github.com/TanStack/query)** - 功能最强大的数据获取库 - 强大的缓存管理 - 无限滚动、分页 - 离线支持 - DevTools 调试工具 - 适合复杂场景 **对比**： - SWR：简单、轻量、够用（推荐新手） - TanStack Query：功能强大、适合复杂应用 ### React UI 与交互 **什么时候需要**：当你需要处理复杂的 UI 交互时（表单、拖拽、动画、内容安全）。这些功能自己写的话要处理大量边界情况，用成熟库更可靠。 - **[React Hook Form](https://github.com/react-hook-form/react-hook-form)** - 表单状态管理 **遇到的问题**：受控组件写起来很繁琐，每个字段都要写 `value`、`onChange`、验证、错误提示、提交状态……代码量爆炸。 **解决方案**：用 Hook 管理表单，代码量减少 70%，性能还更好（减少重渲染）。 **为什么不自己写**：表单验证、错误处理、提交状态、字段依赖、动态表单……自己写的话至少几百行代码，还容易出性能问题。 - **[@dnd-kit/core](https://github.com/clauderic/dnd-kit)** - 拖拽库 **遇到的问题**：拖拽涉及鼠标事件、触摸事件、动画、碰撞检测……自己写至少几百行，还要处理各种边界情况。 **解决方案**：专业的拖拽库，可访问性、触摸支持、动画全都有，API 灵活易用。 **为什么不自己写**：拖拽的边界情况太多了——多点触控、键盘操作、屏幕阅读器、性能优化……自己写容易漏掉 90% 的场景。 - **[sanitize-html](https://github.com/apostrophecms/sanitize-html)** - HTML 内容清理 **遇到的问题**：用户输入的 Markdown 或 HTML 可能包含 XSS 攻击代码（`