Nginx配置应层级合理、职责分明、命名一致、避免深嵌套；主配置仅留骨架，其余按功能拆至conf.d下独立文件，server块内分段注释，location按匹配优先级排序，统一缩进与空格规范。
清晰易读的 Nginx 配置文件，核心在于层级合理、职责分明、命名一致、避免嵌套过深。不是堆参数，而是按“谁管什么”来组织。
主配置与子配置分离
把全局设置（user、worker_processes、error_log 等）保留在 /etc/nginx/nginx.conf 中，仅保留最精简的骨架；其余全部拆到 /etc/nginx/conf.d/ 下按功能或站点命名的独立文件里，比如：
- proxy.conf：反向代理通用参数（proxy_set_header、timeout 等）
- ssl.conf：SSL 公共配置（证书路径、协议、HSTS）
- myapp.conf：某个具体应用的 server 块
- admin.conf：后台管理服务的独立 server
这样修改某项功能时，不用翻完整文件，也避免多人编辑冲突。
server 块内按逻辑分段注释
每个 server 块内部不堆砌指令，用空行+注释划分为明确区块：
- # Basic listen & host：端口、域名、重定向规则
- # SSL config：仅当启用 HTTPS 时出现
- # Static assets：location / { root; index; expires; } 等
- # API proxy：location /api/ { proxy_pass; proxy_set_header; } 等
- # Security headers：add_header X-Content-Type-Options nosniff; 等
每段开头加空行和注释，一眼定位功能区域，排查问题时效率高。
location 块按匹配优先级从上到下排列
Nginx 匹配 location 是顺序扫描+最长前缀/精确匹配优先，所以结构本身影响行为。建议按以下顺序写：
- 精确匹配：location = /healthz { ... }
- 长前缀匹配：location ^~ /static/ { ... }
- 正则匹配（慎用）：location ~* \.(js|css|png)$ { ... }
- 通用兜底：location / { proxy_pass http://backend; }
避免把正则块写在前面导致意外拦截，也方便后续加新路由时插在合适位置。
统一缩进与空格规范
用 2 或 4 个空格缩进（别用 tab），大括号换行对齐，关键指令后加空格再写值：
- ✅ listen 443 ssl http2;
- ✅ proxy_read_timeout 90;
- ❌ proxy_read_timeout 90s;（单位冗余，Nginx 默认秒）
- ❌ root/var/www/html;（缺少空格，语法虽通但难读）
一致性让团队协作、代码审查、自动化解析都更可靠。
