# 整齐排版任意 SQL 查询，而不改动文件

> 在 Mac 访达中用快速查看预览格式化后的 .sql 文件：关键字在同一列中右对齐，连接、条件、CTE 和子查询一目了然。仅在屏幕上排版，绝不修改文件。

挤在三行长行里的查询很难阅读。在 `.sql` 文件上按下空格键，Gander 会让关键字在同一列中右对齐，每个子句、连接和条件都整齐排列。文件本身绝不会改变：**原文** 按原样显示它。

![深色模式下 weekly_report.sql 的 Raw 标签页：查询按原样显示，全部小写，挤在几行长行中。](https://ganderfinder.com/img/features/sql-raw-2x.webp)
![深色模式下 weekly_report.sql 的 Formatted 标签页：SELECT、FROM、JOIN、WHERE、GROUP BY 和 ORDER BY 在同一列中右对齐。](https://ganderfinder.com/img/features/sql-formatted-2x.webp)

## 操作步骤

1. 从 Mac App Store 安装 Gander，并打开一次。
2. 在访达中选择一个 `.sql` 文件，然后按下空格键。
3. 阅读 **格式化** 标签页，或切换到 **原文** 查看文件原样。需要时可开启行号。

## “河流”式排版

Gander 采用经典的“河流”（river）风格：SELECT、FROM、JOIN、WHERE 和 GROUP BY 等子句关键字右对齐，因此其后的内容都从同一列开始。

- 每行一个选取的列，别名对齐
- 连接与其 ON 条件放在一起，每行一个条件，AND 和 OR 位于“河道”中
- CTE、子查询、CASE 表达式和窗口函数采用相应的排版
- 关键字大写，名称、带引号的名称和字符串保留原有大小写

## 安全的设计

只改变空格和关键字大小写。每条语句都会与原文逐词比对，如有任何差异，就按原样保留。Gander 无法安全排版的代码，如存储过程、dbt `{% %}` 块和 psql 脚本，会按原样显示。

## 语法着色，缩略图也一样

两种视图都有语法着色，访达缩略图显示格式化后的查询，让你一眼就能区分各个查询。

## 常见问题

### Gander 会改写我的 .sql 文件吗？

不会。排版只显示在屏幕上。Gander 绝不写入文件，“原文”完全按原样显示它。

### 它能排版哪些 SQL？

排版依据查询的结构，而非某一种方言：SELECT、INSERT、UPDATE、DELETE 和 WITH 语句，以及 QUALIFY 等关键字和 SQL Server 的 GO 批处理。无法安全排版的内容按原样保留。

### 可以拷贝格式化后的查询吗？

可以。拷贝按钮拷贝屏幕上的视图：在“格式化”中拷贝排版后的查询，在“原文”中拷贝原始内容。

## 更多指南

- [在访达中预览 Markdown，渲染效果与 GitHub 一致](https://ganderfinder.com/zh/markdown-quick-look)
- [无需浏览器，在 Mac 上查看 Mermaid 图表](https://ganderfinder.com/zh/mermaid-viewer)
- [直接在访达中将 Markdown 转为 PDF 或 Word 文稿](https://ganderfinder.com/zh/markdown-to-pdf-word)
- [在 Mac 上直接从访达把 CSV 转为 Excel](https://ganderfinder.com/zh/csv-to-excel)
- [无需启动 Jupyter，在 Mac 上阅读 Jupyter 笔记本](https://ganderfinder.com/zh/jupyter-notebook-viewer)
- [访达中的快速 JSON 查看器，也支持 JSONC 和 JSON Lines](https://ganderfinder.com/zh/json-viewer)
- [在访达中查看 SQLite 数据库的内部](https://ganderfinder.com/zh/sqlite-viewer)
- [日志从最新一行打开，错误显示为红色](https://ganderfinder.com/zh/log-viewer)
- [检查 .env 文件，而不让机密出现在屏幕上](https://ganderfinder.com/zh/env-file-viewer)

Gander 可在 Mac App Store 免费下载，没有 App 内购买，无需订阅，无需账户，你预览的任何内容都不会离开你的 Mac。 https://apps.apple.com/app/id6817038818

---

- HTML 版本: https://ganderfinder.com/zh/sql-formatter
- English: https://ganderfinder.com/sql-formatter.md
- Español: https://ganderfinder.com/es/sql-formatter.md
- Deutsch: https://ganderfinder.com/de/sql-formatter.md
- Français: https://ganderfinder.com/fr/sql-formatter.md
- 日本語: https://ganderfinder.com/ja/sql-formatter.md
- Português (Brasil): https://ganderfinder.com/pt/sql-formatter.md
- 支持: https://ganderfinder.com/zh/support
- 隐私政策: https://ganderfinder.com/zh/privacy
- llms.txt: https://ganderfinder.com/llms.txt
- © 2026 65FN LLC