Node.js Best Practices：10 万星标的 Node 开发指南

nodebestpractices 在 GitHub 上已经拿到 105,375 Star 了。

这个仓库由 Yoni Goldberg 维护，做的事情很简单：把 Node.js 开发中公认的最佳实践整理成一份清单。项目架构、错误处理、代码风格、测试、安全、Docker 部署，每个方向都有对应的条目，目前累计超过 100 条。

1、 这个仓库收录了什么

不是教程，不是框架，是一份经过筛选的实践清单。

每条最佳实践都有统一的结构：先给一个 TL;DR 摘要，说清楚建议怎么做；再用 Otherwise 段落说明不这么做会出什么问题；最后附上扩展阅读链接。内容按主题分成 8 大类：

• 项目架构：组件化拆分、三层架构、框架选型、TypeScript 使用建议
• 错误处理：async/await 规范、错误分类、集中式处理、日志工具选择
• 代码风格：ESLint 配置、命名规范、箭头函数、const/let 选择
• 测试：API 测试、AAA 模式、测试覆盖率、中间件隔离测试
• 生产部署：监控、日志、反向代理、零停机部署、LTS 版本选择
• 安全：依赖漏洞扫描、密码加密、JWT 管理、SQL 注入防护
• Docker：多阶段构建、镜像瘦身、密钥管理、优雅停机
• 性能：事件循环阻塞、原生方法优先

2、 为什么值得看

写 Node.js 的人多少都踩过坑：回调地狱、未捕获的 Promise 异常、生产环境内存泄漏、Docker 镜像体积膨胀。这些问题的解法散落在各种博客和 Stack Overflow 回答里，找起来费劲，质量也参差不齐。

这个仓库把这些经验集中到一个地方。每条建议都标注了优先级，用标签区分战略性实践（strategic）、新增内容（new）和进阶内容（advanced）。你不用从头读到尾，按自己的阶段挑着看就行。

2026 年初刚做过一轮大更新，推荐的库换了一批，框架选型建议也跟进了当前生态。新增了 TypeScript 使用策略、事件监听器错误处理、Promise 返回前 await 等条目。

3、 几条值得关注的实践

组件化拆分

建议按业务模块组织目录结构，每个组件有独立的 API、业务逻辑和数据访问层。不是物理隔离，Monorepo 里也能做。好处是每次改动的影响范围可控，部署风险小。

错误分类处理

把错误分成两类：业务错误（operational）和程序错误（programmer/catastrophic）。业务错误可以优雅返回给调用方，程序错误应该记录日志后重启进程。混为一谈会导致要么频繁重启，要么带着隐患继续跑。

TypeScript 策略

仓库对 TypeScript 的态度比较务实：类型安全有价值，但研究显示它只能提前发现约 20% 的 bug。建议用简单类型，高级特性在真正需要时再引入，避免为了类型体操增加代码复杂度。

Docker 多阶段构建

用多阶段构建分离编译环境和运行环境，最终镜像只包含运行必需的文件。配合非 root 用户运行、显式内存限制、.dockerignore 排除密钥等实践，能显著提升容器安全性。

4、 适合谁看

正在写 Node.js 后端服务的开发者，不管是新手还是有几年经验的人，都能从这份清单里找到有价值的内容。新手可以当作避坑指南，有经验的开发者可以用来做团队规范参考。

仓库本身不提供代码模板或脚手架，但作者另外维护了一个叫 Practica.js 的项目，把部分最佳实践落地成了可运行的示例代码，想看具体实现的可以对照着看。

护了一个叫 Practica.js 的项目，把部分最佳实践落地成了可运行的示例代码，想看具体实现的可以对照着看。