nginx -T用于导出Nginx实际加载的完整配置树，含include展开、块合并、行号标注及构建信息；它基于语法合法前提，提供reload后的真实视图，非单纯语法检查。
nginx -T 是 Nginx 提供的一个调试命令，用于输出**经过所有 include 指令合并、展开后的完整生效配置**（即 Nginx 实际加载运行的配置），并附带每行配置所在的文件路径和行号，非常便于排查配置覆盖、语法错误或 include 路径问题。
执行 nginx -T 的前提条件
该命令要求：
- Nginx 已正确安装且 nginx 可执行文件在 PATH 中（或使用绝对路径，如
/usr/sbin/nginx -T） - 主配置文件（通常是
/etc/nginx/nginx.conf）语法正确，且所有被 include 的子配置文件都存在、可读、无语法错误 - 无需 root 权限即可运行（但若配置中包含需要权限的路径，如某些日志路径或 upstream socket，可能报错；此时可先用
nginx -t验证语法）
基本用法：导出并查看完整配置
直接运行：
nginx -T
终端会滚动输出全部合并后的配置，每行开头类似：
# configuration file /etc/nginx/nginx.conf:12
worker_processes auto;
# configuration file /etc/nginx/conf.d/default.conf:5
listen 80;
这种注释行明确标出了该配置项来自哪个文件、哪一行，对定位来源极有帮助。
常用组合技巧提升实用性
-
保存到文件便于搜索分析：
nginx -T > full-config.txt -
过滤查看特定模块或指令（例如只看 server 块）：
nginx -T | grep -A 5 -B 2 "server {"或用less +/server交互浏览 -
快速检查是否加载了某份配置：
nginx -T | grep "/etc/nginx/sites-enabled/myapp"（注意路径需与 include 中写的一致） -
对比修改前后的差异（配合 git 或备份）：
先保存旧版：nginx -T > config-before.txt；改完后保存新版，再用diff config-before.txt config-after.txt
注意事项与常见问题
- 如果看到
nginx: [emerg] ... no such file等错误，说明某个 include 路径不存在或权限不足——先运行nginx -t查明具体哪一行出错 -
nginx -T不会校验配置逻辑是否合理（如重复 listen、冲突的 server_name），只做语法解析和合并。仍需靠nginx -t和实际 reload 测试行为 - 部分发行版（如较老的 CentOS 7 自带 Nginx）可能不支持
-T，需确认版本 ≥ 1.9.2（2015 年后普遍支持） - 若配置中用了变量（如
$realpath_root）或运行时计算的值，-T输出的是静态文本，不会展开变量结果
