运行 nginx -t 可静态验证配置语法正确性，输出“syntax is ok”和“test is successful”即通过；支持 -c 指定配置文件、-p 设置前缀路径；能发现拼写错误、路径无效、端口冲突等问题，但不检查SSL证书、后端连通性等运行时问题。
直接运行 nginx -t 就能完成最基本的语法有效性测试，它不启动服务、不改变运行状态，只做静态解析和基础合法性校验，是修改配置后必须执行的第一步。
默认路径下快速验证
大多数情况下，Nginx 会读取默认配置文件（如 /etc/nginx/nginx.conf 或 /usr/local/etc/nginx/nginx.conf），此时只需：
- 执行 sudo nginx -t（Linux 常需 sudo；macOS 若用 Homebrew 安装，通常无需）
- 看到两行输出即表示通过：
nginx: the configuration file /path/to/nginx.conf syntax is ok
nginx: configuration file /path/to/nginx.conf test is successful - 若失败，错误信息会明确指出文件名、行号和问题类型，比如：
nginx: [emerg] unknown directive "lsten" in /etc/nginx/conf.d/site.conf:15（明显是 listen 拼错）
指定配置文件路径测试
当你使用自定义配置、多实例部署或临时调试时，必须用 -c 参数显式指定：
- nginx -t -c /opt/myapp/nginx.conf —— 测试指定文件
- 确保路径准确，且 Nginx 进程有读取权限（尤其在非 root 用户下）
- 若配置中用了相对路径（如 include conf.d/*.conf; 或 access_log logs/access.log;），还需配合 -p 指定前缀目录：
nginx -t -c /opt/myapp/nginx.conf -p /opt/myapp/
理解 -t 的实际能力范围
它能帮你发现的典型问题包括：
- 指令拼写错误（lsten → listen）、缺少分号或括号不匹配
- include 的子配置文件路径不存在、无法访问
- 端口已被占用（如两个 server 都监听 80）、server_name 重复
- 指令使用位置错误（例如把 location 写在 http 块之外）
但它不会检查：SSL 证书是否有效、后端 upstream 是否可达、rewrite 是否导致跳转循环、worker 进程对日志目录是否有写权限——这些要靠真实请求或日志观察来发现。
配合 reload 的安全操作习惯
每次改完配置，建议按这个顺序走：
- 先跑 nginx -t，确认输出 success
- 再执行 nginx -s reload 或 systemctl reload nginx
- 如果 -t 报错，别 reload，否则可能让服务直接退出
- 需要快速查看当前生效的完整配置内容（含所有 include 合并结果），可用 nginx -T（大写 T）
