SuperAPI AI 工具集

nodejs-best-practices

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:该技能用于在 Node.js 开发中做架构决策,包括选择框架、设计异步模式、应用安全与部署最佳实践。它教授决策原则,而非固定代码模板,因此需要根据具体上下文选择方案,并在需求不明确时向用户询问偏好。

主要能力:提供 2025 年框架选型决策树,例如边缘/无服务器场景考虑 Hono,高性能 API 考虑 Fastify,企业级与团队熟悉度考虑 NestJS,遗留与生态最大考虑 Express,全栈前端考虑 Next.js API Routes 或 tRPC;并给出 Hono、Fastify、Express 在适用场景、冷启动、生态、TypeScript 与学习曲线上的对比原则。运行时方面涉及 Node.js 22+ 的 --experimental-strip-types 直接运行 .ts 文件、ESM 与 CommonJS 的取舍,以及 Node.js、Bun、Deno 的适用方向。架构上建议分层结构:控制器/路由层处理 HTTP 与边界输入校验,服务层承载业务逻辑且与框架无关,仓储层只负责数据访问。错误处理强调集中式处理、自定义错误类、顶层中间件捕获与一致响应格式,并区分客户端可见信息与日志中的完整堆栈。异步模式给出 async/await、Promise.all、Promise.allSettled、Promise.race 的适用条件,并提醒区分 I/O 密集与 CPU 密集任务,避免在生产中使用同步方法、将 CPU 密集工作卸载到 worker 线程或使用流处理大数据。校验原则强调在边界处校验,包括 API 入口、数据库操作前、外部数据与环境变量启动时。

使用方式与限制:该技能以原则和决策树形式呈现,不提供可直接复制的完整代码;框架与模式选择应基于部署目标、冷启动要求、团队经验与遗留代码等因素。资料未提供具体安装命令、收费信息或平台支持细节。