mcpField
N
nodejs-backend-patterns

nodejs-backend-patterns

github.com/wshobson开发41.9k48.9k 次安装2 周前更新
代码仓库

关于 nodejs-backend-patterns

面向 Node.js 后端开发者的模式指南,涵盖 API、微服务和可扩展架构。提供 TypeScript、验证、错误处理、数据库及测试等实践建议。

主要功能

  1. 01REST API 与 GraphQL 模式
  2. 02微服务与架构设计
  3. 03认证、授权与中间件
  4. 04数据库集成与后台任务
  5. 05日志、监控与健康检查

适用场景

  1. 01设计 Node.js 微服务架构
  2. 02为 API 配置认证和错误处理
  3. 03集成 SQL 或 NoSQL 数据库
  4. 04规划后台任务与实时应用

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/wshobson/agents --skill nodejs-backend-patterns

安装后在 Claude Code 中输入/nodejs-backend-patterns确认已加载。

附带文件references/advanced-patterns.mdreferences/details.md

详细介绍

Node.js 后端模式

为构建可扩展、可维护且可用于生产环境的 Node.js 后端应用提供全面指导,涵盖现代框架、架构模式与最佳实践。

何时使用此技能

  • 构建 REST API 或 GraphQL 服务
  • 使用 Node.js 创建微服务
  • 实现身份认证与授权
  • 设计可扩展的后端架构
  • 设置中间件与错误处理
  • 集成数据库(SQL 和 NoSQL)
  • 使用 WebSockets 构建实时应用
  • 实现后台任务处理

详细模式与完整示例

详细的模式文档位于 references/details.md。当上述导航层级不足以满足需求时,请阅读该文件。

最佳实践

  1. 使用 TypeScript:类型安全可防止运行时错误
  2. 实现恰当的错误处理:使用自定义错误类
  3. 验证输入:使用 Zod 或 Joi 等库
  4. 使用环境变量:绝不硬编码密钥
  5. 实现日志记录:使用结构化日志(Pino、Winston)
  6. 添加速率限制:防止滥用
  7. 使用 HTTPS:在生产环境中始终如此
  8. 正确实现 CORS:不要在生产环境中使用 *
  9. 使用依赖注入:更易于测试与维护
  10. 编写测试:单元测试、集成测试和 E2E 测试
  11. 处理优雅关闭:清理资源
  12. 使用连接池:用于数据库
  13. 实现健康检查:用于监控
  14. 使用压缩:减小响应体积
  15. 监控性能:使用 APM 工具

测试模式

有关全面的测试指导,请参阅 javascript-testing-patterns 技能。

评论

支持 Markdown