用途:为编写、审查或重构 nginx C 模块提供开发准则,依据 nginx 官方开发文档与社区经验整理,包含 8 个类别共 49 条按影响程度排序的规则,目的是避免崩溃、内存泄漏和未定义行为。
适用场景:编写新的 nginx C 模块(handler、filter、upstream、load-balancer);实现配置指令与合并逻辑;用 nginx pool 和共享内存区管理内存;处理 HTTP 请求生命周期(读取 body、子请求、终结);使用事件循环、定时器和线程池。
主要能力(按优先级分类,带规则前缀):1. 内存管理(CRITICAL,mem-),如用 pool 分配替代堆 malloc、检查每次分配返回值、用 ngx_pcalloc 初始化结构体等;2. 请求生命周期(CRITICAL,req-),如请求只终结一次、终结后不再访问请求、异步处理 body、内部重定向后返回等;3. 配置系统(HIGH,conf-),如用 UNSET 常量初始化配置字段、合并所有字段、正确的 context flags、以 ngx_null_command 结束命令数组;4. 处理器开发(HIGH,handler-);5. 过滤链(MEDIUM-HIGH,filter-);6. 上游与代理(MEDIUM,upstream-);7. 事件循环与并发(MEDIUM,event-);8. 数据结构与字符串(LOW-MEDIUM,ds-)。
使用方式:按需阅读各参考文件中的详细说明与代码示例;参考 references/_sections.md 了解类别定义与排序,assets/templates/_template.md 用于新增规则,metadata.json 提供版本与引用信息。
限制:资料未提供安装命令、具体代码示例内容、收费或平台信息。本技能为开发准则集合,不替代 nginx 官方文档实际版本差异的核对。