Nginx 配置格式化工具

格式化 nginx 配置:每条指令一行、嵌套块缩进,保留注释和带引号的字符串,并能发现未闭合的块和缺失的分号。

输出

完全在浏览器中运行,您的数据不会被上传。

相关工具

查看全部

什么是 Nginx 配置格式化?

Nginx 配置格式化工具会为 nginx 配置文件重新缩进:每条指令占一行,server 和 location 等块会缩进,空行最多保留一个。它还会报告结构性错误——大括号不平衡、引号未闭合以及指令缺少 ;。

如何使用 Nginx 配置格式化

  1. 粘贴你的 nginx 配置(nginx.conf 或某个 server 块)。
  2. 选择 缩进(nginx 的惯例是 4 个空格)。
  3. 点击 格式化(输入时输出也会更新)。
  4. 修正报告的错误,然后复制或下载结果。

示例

输入
server{listen 80;server_name example.com; # main
location / {root /var/www;}}
输出
server {
    listen 80;
    server_name example.com; # main
    location / {
        root /var/www;
    }
}

何时使用 Nginx 配置格式化

适合整理从教程复制来的配置、审查改动,或找出 nginx -t 提示的缺失大括号或分号。它只检查结构,无法判断某条指令在特定上下文中是否有效;重新加载之前务必运行 nginx -t。

Nginx 配置格式化 的工作原理

分词器把文本拆分为单词、带引号的字符串("…" 和 '…')、${variables}、# 注释、大括号和分号,并记录行号和列号。输出时,每条指令的各个单词以单个空格连接并以 ; 结尾,块以 { 开始,并在单独的一行中关闭。位于指令同一行末尾的注释仍留在该行。带引号的字符串和正则表达式会原样复制。格式化器并不认识指令名称,因此绝不会改动你的参数。

常见用例

  • 整理单行或缩进混乱的 server 块
  • 找出未闭合的 location 块
  • 提交到 Git 前规范配置
  • 为文档格式化配置片段

安全提示

所有处理都在你的浏览器本地完成,粘贴的代码不会被上传。

常见问题

会验证指令名称吗?

不会。它只检查大括号、引号和分号。完整验证请使用 nginx -t。

注释会保留吗?

会,包括指令行末尾的注释。

Lua 块(content_by_lua_block)怎么办?

它们会按 nginx 语法分词,因此其中的 Lua 代码可能被重新排版;请不要把这类文件交给格式化器。

探索更多分类