用途:在处理 Node.js 代码时获取领域知识,帮助构建健壮、高性能、可维护的应用。
主要能力:以规则文件形式覆盖错误处理、异步与 Promise 模式、流、ES Modules 与 CommonJS、测试策略、node:test 不稳定测试诊断、node_modules 探索、性能优化、缓存、性能分析与基准测试、日志与调试、环境配置与密钥管理、优雅关闭与信号处理、TypeScript 配置与类型剥离。
TypeScript 类型剥离:为 Node.js 编写 TypeScript 时,建议使用类型剥离(Node.js 22.6+)而非 ts-node、tsx 等构建工具,运行时直接移除类型注解而不转译。兼容要求:类型导入用 import type;用 const 对象代替 enum;避免 namespace 与参数属性;导入使用 .ts 扩展名。示例文件 greet.ts 可直接运行:node greet.ts。
常见工作流:优雅关闭按注册 SIGTERM/SIGINT 处理器、停止接收新工作、排空在途请求、关闭外部连接(数据库、缓存)、以适当退出码退出执行;错误处理按定义共享错误基类、区分操作性错误与程序员错误、添加异步边界处理器(process.on('unhandledRejection'))、沿调用栈传播类型化错误、响应或崩溃前带上下文记录日志;诊断不稳定测试可用 --test-only 隔离、检查共享状态或定时器依赖、检查异步清理顺序、临时加重试作为诊断、修复根因;性能分析先复现真实负载、用 --cpu-prof 采集 CPU 剖面、定位热点函数、检查流背压或不必要序列化、用基准验证改进。
使用方式:按需阅读各规则文件获取详细说明与代码示例,如 rules/error-handling.md、rules/async-patterns.md、rules/streams.md、rules/modules.md、rules/testing.md、rules/flaky-tests.md、rules/node-modules-exploration.md、rules/performance.md、rules/caching.md、rules/profiling.md、rules/logging.md、rules/environment.md、rules/graceful-shutdown.md、rules/typescript.md。
限制:资料未提供安装命令、收费方式、支持平台与具体版本兼容范围等细节。