Navicat SQL格式化需先启用并重启软件；调整Wrap、换行、对齐等参数提升可读性；注意hint失效、反引号丢失、UNION类型不一致等隐性错误；批量处理应使用sqlformat等命令行工具。
格式化没反应？先确认开关开了且软件已重启
Navicat 的 SQL 格式化功能默认是关闭的，按 Ctrl+Shift+F（Windows）或 Cmd+Shift+F（macOS）没反应，90% 是因为没启用或没重启。路径如下：
Windows：工具 → 选项 → 编辑器 → SQL 格式化 → 勾选「启用 SQL 格式化」
macOS：Navicat → 偏好设置 → Editor → SQL Formatting → 勾选 Enable SQL formatting
勾完必须完全退出 Navicat（不是关标签页），再重新打开——已打开的查询窗口不会加载新配置。
超长查询挤成一行？调这三项关键参数
复杂查询嵌套多、字段多、条件长，格式化后仍难读，通常不是引擎问题，而是参数没对齐：
-
Wrap after N characters设为80～100，避免WHERE a = 1 AND b = 2 AND c = 3 AND ...横向溢出 -
Put each clause on new line必须开启，否则SELECT/FROM/WHERE挤在同一行 -
Align multiple conditions必须同步开启，否则AND和OR不左对齐，看起来像缩进错误 -
Indent width建议设为4，设2在三层子查询里容易混淆层级，设8会导致右侧空间严重不足
格式化后执行报错？小心这些隐性改动
Navicat 格式化会解析语法树，不是纯文本替换。以下情况极易引入问题：
- 含 hint 的语句如
/*+ USE_INDEX(t1 idx_a) */，格式化可能删掉行尾空格，导致注释与后续 SQL 粘连，hint 失效 - MySQL 下带空格的表名如
`order detail`，格式化有时漏掉反引号，变成order detail，直接语法错误 -
UNION查询中前后子查询字段类型不一致（如INTvsVARCHAR），格式化会强制换行暴露隐式转换，原语句能跑，改完反而报错 - 语句含未闭合单引号、括号不匹配、或 PostgreSQL 特有语法（如
RETURNING），格式化器会卡在解析阶段，弹出Error formatting SQL: Syntax error near ...
批量处理多个超长 SQL 文件？别依赖 Navicat 自带功能
Navicat 只支持当前编辑器窗口内格式化，不支持文件夹遍历、命令行调用或批量导入导出。想统一处理几十个 SQL 文件：
- 用开源命令行工具
sqlformat（支持 MySQL/PostgreSQL/Oracle 方言），配合 shell 脚本批量处理 - 导出 Navicat 配置为
navicat_sql_format.xml，用脚本提取其中缩进、换行等规则，映射到sqlformat参数，保证风格一致 - 若必须用 Navicat，可新建空白查询页，用
Execute SQL File并勾选Format SQL before execution，但仅限执行前临时格式化，不保存结果
真正麻烦的不是怎么按快捷键，而是格式化后要不要再手动修 hint、补反引号、核对 UNION 字段顺序——这些没法自动化，得人眼盯住。
