使用 -t 参数配合 -c 参数指定配置文件路径即可进行语法检查。例如执行 nginx -t -c /path/to/nginx.conf，nginx 会加载该文件并验证其语法正确性，若存在错误会在终端输出具体报错信息。
如何验证包含子配置文件的完整结构
当主配置文件通过 include 指令引入其他文件时，-t 检查会自动递归验证被引入的文件。只需确保 -c 指向的主入口文件路径正确，Nginx 解析器会按层级读取所有依赖项，任何一层的语法错误都会导致检查失败并停止。
nginx -t -c /etc/nginx/custom_nginx.conf nginx: the configuration file /etc/nginx/custom_nginx.conf syntax is ok nginx: configuration file /etc/nginx/custom_nginx.conf test is successful
如何定位具体的语法错误行号
如果检查失败，Nginx 会在标准错误输出中明确提示出错的文件名和行号。开发者应直接查看终端输出的最后一行错误详情，它通常格式为 [emerg] ... in /path/to/file:line_number，根据该行号修改对应代码后重新运行命令即可确认修复。
nginx -t -c /etc/nginx/broken_nginx.conf nginx: [emerg] unknown directive "wrong_directive" in /etc/nginx/broken_nginx.conf:15 nginx: configuration file /etc/nginx/broken_nginx.conf test failed
基于默认配置路径的静默检查行为
如果不使用 -c 参数，Nginx 会尝试加载编译时指定的默认路径（如 /etc/nginx/nginx.conf）。若该路径不存在或无权限访问，命令将直接报错退出，不会进行任何语法分析。因此，在非默认路径下测试必须显式指定 -c，否则无法获得预期的检查结果。
