规范nginx配置需统一缩进（强制4空格/禁tab）、命名（业务-环境-功能分层）、结构（include解耦）及配套机制（ci校验、初始化脚本、批量格式化）。
规范 Nginx 配置文件的缩进与命名，核心是建立可执行、易识别、能自动校验的一致性规则，而不是靠人工记忆或临时约定。团队协作中，混乱的缩进和随意的命名会直接拖慢排查速度、增加合并冲突、阻碍自动化部署——尤其在多人共管多环境配置时。
统一缩进：用工具强制而非靠自觉
缩进不一致（比如混用空格与 Tab、2 空格 vs 4 空格、块内缩进错位）是配置出错的常见诱因。手动调整既低效又不可靠。
- 采用 nginxfmt.py 工具批量格式化，它默认使用 4 空格缩进，符合主流运维习惯；可通过
-i 2切换为 2 空格，命令示例：nginxfmt.py -i 4 site.conf - 所有 CI/CD 流水线中加入格式化检查步骤：提交前运行
nginxfmt.py --check，失败则阻断合并，确保仓库内配置始终整洁 - 禁止使用 Tab 缩进——nginxfmt 默认只处理空格，且会报错提示含 Tab 行，从源头杜绝混用
命名规范：按作用+环境+层级清晰分层
命名不是为了好看，而是让任何人一眼看懂“这是谁的、在哪用、管什么”。避免出现 nginx.conf.bak、test.conf、new.conf 这类无意义名称。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 主配置固定为
/etc/nginx/nginx.conf，仅保留全局指令（user、worker_processes、events、include http） - HTTP 虚拟主机配置统一放在
/etc/nginx/conf.d/，命名格式：{业务名}-{环境}-{功能}.conf，例如：shop-prod-web.conf、api-staging-api.conf - 上游（upstream）、重写规则、SSL 证书等复用模块，单独存为
/etc/nginx/includes/下的语义化文件，如：upstream-app-servers.conf、ssl-tls-1-3.conf
结构拆分：用 include 实现逻辑解耦
把所有配置堆在 nginx.conf 里，等于把整栋楼的电路图画在一张 A4 纸上——看得见，但改不动。拆分不是为了多几个文件，而是让变更边界清晰、影响范围可控。
- 每个
server块对应一个独立.conf文件，按域名或服务划分，便于权限隔离与灰度发布 - 公共段（如日志格式、常用 rewrite 规则、安全头）抽成
/etc/nginx/common/目录下的 include 文件，通过include common/*.conf;引入 - 开发/测试/生产环境配置通过不同 include 路径区分，例如：
include environments/prod/*.conf;，避免硬编码环境变量
配套机制：让规范真正落地
再好的规范，没有配套动作就只是文档里的装饰。关键在于把约束嵌入日常操作流。
- 在 Jenkins 或 GitLab CI 中集成
nginx -t+nginxfmt --check双校验，任一失败即中断构建 - 新成员入职时，提供一键初始化脚本：自动创建标准目录结构、预置命名模板、安装 nginxfmt 并配置 Git pre-commit hook
- 定期运行
find /etc/nginx -name "*.conf" -exec nginxfmt.py -b {} \;批量备份并格式化存量配置，降低历史包袱
