Node.js 最佳实践：如何做出正确的架构决策
本技能旨在解决 Node.js 开发中“盲目复制代码模式”的问题，通过一套完整的决策树和原则，指导开发者在 2025 年的生态环境下选择合适的框架、运行时和架构模式。
为什么需要这个技能
Node.js 生态极其丰富，但也存在严重的碎片化。很多开发者在选择框架或设计异步流时，习惯于使用“最流行”的方案（如 Express），而忽略了当前的部署环境（如 Edge Runtime）或性能需求（如高并发 API）。
真正的最佳实践不是记忆某段代码，而是建立一套决策逻辑：根据部署目标、团队经验和性能瓶颈，在多个可行方案中选出最优解。
适用场景
- 技术选型阶段：在启动新项目时，决定使用 Hono、Fastify 还是 NestJS。
- 架构设计阶段：规划如何组织 Controller、Service 和 Repository 层以保证可测试性。
- 性能调优阶段：分析 CPU 密集型任务是否阻塞了事件循环，决定是否引入 Worker Threads。
- 安全加固阶段：在 API 边界构建统一的验证机制和错误处理体系。
核心工作流
本技能将 AI 的引导逻辑分为四个关键决策维度：
1. 框架与运行时的选择
不再默认推荐单一框架，而是基于场景选择：
- Edge/Serverless
Hono（极速冷启动，零依赖）。 - 高性能 API
Fastify（低开销，高性能）。 - 企业级大团队
NestJS（强规范，依赖注入）。 - 通用/遗留系统
Express（生态最广）。
2. 分层架构原则
倡导“职责单一”的流动模型：
请求 Controller（处理 HTTP 细节） Service（核心业务逻辑） Repository（数据访问）。这种结构允许在不影响业务逻辑的情况下更换数据库或框架。
3. 异步与并发决策
根据任务性质选择模式：
- 顺序执行：
async/await。 - 独立并行：
Promise.all。 - 容忍部分失败：
Promise.allSettled。 - CPU 密集型：严禁在主线程同步执行，必须迁移至 Worker Threads 或外部队列。
4. 安全与验证防御
实施“边界验证”策略：在 API 入口、数据库写入前、外部 API 响应时进行 Zod 或 Valibot 校验，确保内部数据流的纯净。
下载和安装
下载 nodejs-best-practices 中文版 Skill ZIP
解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。
你可能还需要
暂无推荐