pre-commit 不适合检查 Nginx 配置语法，因其运行于本地、缺乏服务端环境（如 nginx 二进制、模块、include 文件、路径权限），且配置含运行时变量，无法真实模拟；应改在 CI/CD 中用标准环境执行 nginx -t。
不能直接用 Git pre-commit 钩子检查 Nginx 配置语法，因为 pre-commit 运行在开发者本地工作区，而 Nginx 配置文件通常部署在服务器端，且 nginx -t 依赖 Nginx 二进制和运行时环境（如模块、路径权限、include 文件等），本地未必具备。
为什么 pre-commit 不适合做 Nginx 配置语法检查
Git pre-commit 钩子本质是拦截「即将提交的代码变更」，适用于检查源码类文件（如 .py、.js）；但 Nginx 配置文件（.conf）往往：
- 不参与日常开发提交，而是通过运维流程单独发布（如 Ansible、CI/CD 推送）
- 依赖服务端上下文：nginx -t 需读取 /etc/nginx/ 下所有 include 文件、验证路径权限、加载动态模块
- 本地缺少真实环境：比如没有安装 nginx，或版本不一致，导致 nginx -t 报错或漏检
- 配置中常含变量、$host、$realip_remote_addr 等运行时变量，pre-commit 无法模拟求值
真正可行的拦截方式：CI/CD 阶段检查
把语法验证放在代码合并前的持续集成环节，既保证环境一致性，又不干扰开发节奏。推荐做法：
- 在 CI 流水线（如 GitHub Actions、GitLab CI）中，拉取最新 nginx 镜像，挂载 conf 文件，执行 nginx -t
- 若使用 Ansible 管理配置，可在 playbook 中加入 command 模块调用 nginx -t，并设 ignore_errors: no
- 对关键 conf 文件（如 sites-enabled/*.conf），加 shell 脚本批量验证：
for f in *.conf; do nginx -t -c "$f" || exit 1; done - 结合 nginxfmt 工具做格式预检，避免因缩进/括号混乱导致的误报
如果硬要在本地 pre-commit 做轻量检查，可限制范围
仅适用于「本地开发调试 Nginx 配置」的特殊场景（如前端代理配置写在 nginx.conf 中并随项目提交）。此时可：
- 只检查语法结构：用正则粗筛明显错误（如统计 { 和 } 数量、匹配 unquoted 字符串后是否跟分号）
- 调用本地已安装的 nginx（需提前约定版本），执行
nginx -t -c $(git rev-parse --show-toplevel)/nginx-dev.conf -q - 跳过 include 行，或用
nginx -T展开全部配置后再校验（注意该命令会加载实际模块，需确保本地环境可用） - 将检查结果仅作警告（warn），不阻断提交，避免误伤
本质上，Nginx 配置不是“代码”，而是“运行时声明”。它的正确性必须在目标环境中验证，而不是靠提交前静态扫描。
