nginx主配置文件必须命名为nginx.conf且位置固定，子配置按功能分层命名（如sites-available/example.com.conf），禁用空格、中文及特殊字符，避免使用.bak等易被误加载的文件名。
Nginx 本身不强制要求配置文件命名规则，但生产环境中普遍遵循一套清晰、可维护的命名惯例，目的是便于识别作用域、避免冲突、支持自动化管理。
配置文件存放位置决定命名逻辑
主流安装方式下，主配置文件固定为 nginx.conf，位于：
-
/etc/nginx/nginx.conf（包管理器安装，如 Ubuntu/Debian/CentOS） -
/usr/local/nginx/conf/nginx.conf（源码编译安装）
该文件是唯一被 Nginx 启动时默认加载的入口，必须叫 nginx.conf，不可更改。
include 引入的子配置建议按功能分层命名
nginx.conf 中通常用 include 指令加载外部配置，这部分文件名需体现用途，推荐格式：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
虚拟主机类：
sites-available/example.com.conf（启用时软链到sites-enabled/） -
通用模块类：
upstream.conf、gzip.conf、security.conf -
环境区分类：
prod.conf、staging.conf（配合-c参数按需加载） -
协议/端口类：
https-listen.conf、http2-enable.conf
⚠️ 注意：所有 .conf 文件名不能含空格、中文、特殊符号（如 @, $, #），推荐只用小写字母、数字、短横线 - 和下划线 _。
不同层级配置块不靠文件名区分，而靠语义嵌套
比如：
- 全局参数（
user,worker_processes）写在nginx.conf的最外层（main 块） -
events { ... }和http { ... }是固定关键字块，不可改名 -
server { ... }块内通过server_name example.com;标识站点，而非靠文件名 -
location /api/ { ... }的路径匹配逻辑由内容决定，与文件名无关
实际运维中要避开的命名陷阱
- ❌ 不要用
nginx.conf.bak、nginx.conf.old放在 conf 目录下——Nginx 启动时若include *.conf，可能误加载导致语法错误 - ❌ 不要命名为
default.conf并直接放在conf.d/下却不加server_name或listen，易引发默认 server 冲突 - ✅ 推荐做法：无用配置先移出 conf 目录，或重命名为
xxx.conf.disabled（多数include不匹配.disabled后缀）
本质上，Nginx 看的是配置内容的结构和指令有效性，文件名只是人读的索引。规范命名的本质，是让团队能一眼看懂“这个文件管什么”，而不是让 Nginx 认得出来。
