SuperAPI AI 工具集

nodejs-best-practices

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:这是一套 Node.js 开发原则与决策指南,目标是教会开发者根据具体情境思考技术选择,而不是记忆固定代码模式。资料明确要求:当用户偏好不清晰时先询问用户,不要每次默认同一套方案。

主要能力:一是框架选型决策树,边缘/无服务器指向 Hono,高性能 API 指向 Fastify,企业与团队熟悉度指向 NestJS,遗留与生态最大指向 Express,全栈前端可考虑 Next.js API Routes 或 tRPC;并给出各框架在适用场景、冷启动、生态、TypeScript、学习曲线上的对比原则。二是运行时考量,Node.js 22+ 可用 --experimental-strip-types 直接运行 .ts 文件;模块系统上 ESM 适合新项目,CommonJS 适合既有代码库;运行时可在 Node.js、Bun、Deno 之间按用途选择。三是架构,建议路由/控制器、服务、仓储三层结构,并说明小脚本与原型可简化。四是错误处理,建议自定义错误类、顶层中间件捕获、统一响应格式,客户端只给状态码与友好信息,日志保留堆栈、请求上下文与时间戳。五是异步模式,按顺序用 async/await,并行独立操作用 Promise.all,可失败的并行用 Promise.allSettled,竞速或超时用 Promise.race;I/O 密集适合异步,CPU 密集应使用 worker threads 或卸载处理。六是校验、安全与测试原则,校验放在边界处,安全清单涵盖参数化查询、bcrypt 或 argon2、JWT 校验、限流、Helmet、HTTPS、CORS、环境变量与依赖审计;测试分单元、集成与 E2E,Node.js 22+ 可用 node --test src/**/*.test.ts。

使用方式:作为开发前与实现中的决策参考,先确认部署目标、冷启动是否关键、团队经验与是否有遗留代码,再动手。

限制与未提供:资料未给出具体安装命令、收费与价格、性能数字的独立验证、完整代码示例及官方文档细节,相关事实暂未提供。