必须启用「启用 SQL 格式化」开关并重启 Navicat,否则 XML 规则不生效;跨平台默认关闭,需手动开启并彻底重启;导出 XML 实现 Git 版本可控同步;关键参数(大小写、缩进、换行)须团队统一;格式化可能隐式改变语义,需人工或工具校验。

必须先启用「启用 SQL 格式化」开关并重启 Navicat,否则导入的 XML 规则完全不生效——这是 70% 团队配置失败的根源。
启用格式化开关是跨平台生效的硬性前提
Windows 和 macOS 上该功能默认关闭,且修改后不重启不会加载新规则。Ctrl+Shift+F 或右键「美化 SQL」无响应?大概率就卡在这步。
- Windows 路径:
工具 → 选项 → 编辑器 → SQL 格式化,勾选启用 SQL 格式化 - macOS 路径:
Navicat → 偏好设置 → SQL 编辑器,勾选启用 SQL 格式化 - 务必彻底退出 Navicat(不是仅关闭窗口),再重新启动;已打开的查询页仍沿用旧规则
- 中文输入法下
Ctrl+Shift+F常被系统拦截,建议切英文输入法或改用右键菜单验证
导出 XML 配置文件实现 Git 可控同步
Navicat 没有云端同步,但支持标准 XML 导出/导入——这才是真正可版本管理、可 diff、可审计的方案。
- 配置好本地参数后,在「美化 SQL 选项…」对话框右下角点
导出,保存为navicat_sql_format.xml - 提交到项目仓库,路径建议统一为
.navicat/format/navicat_sql_format.xml - 团队成员导入:打开「美化 SQL 选项…」→
导入→ 选中该 XML → 重启 Navicat -
Navicat 16与Navicat 17的 XML 结构存在微小差异,混用会导致导入失败,团队需统一主版本
关键参数必须对齐,否则 Git diff 全是噪音
即使用了同一份 XML,若以下三项理解偏差,格式效果会南辕北辙,每次格式化都触发无意义变更。
-
Uppercase keywords:决定SELECT/WHERE是否强制大写。团队约定关键字大写就必须统一勾选,否则每次都会抖动大小写 -
Indent width:设为4(不是 2 或 8)。缩进过浅难分辨嵌套层级,过深易挤出编辑器可视区 -
Wrap after N characters:推荐80~100。设为 0 会导致长条件堆成单行,横向滚动成为常态 - 务必取消勾选
保留原有空格,否则粘贴他人代码后,手写缩进会干扰自动对齐逻辑,尤其影响JOIN ON条件对齐
格式化可能悄悄改变 SQL 语义,这点最容易被忽略
XML 配置只管外观,但 Navicat 的格式化引擎会在后台重排文本——某些操作会引发执行报错,比如:
- HINT(如
/*+ USE_INDEX(t idx_a) */)可能被换行或截断,导致失效 - 反引号
`在字段名上可能被意外移除,MySQL 中变成普通标识符,大小写敏感逻辑丢失 -
UNION后未显式写ALL,格式化可能隐式补全或删减括号,影响去重行为
这些改动不会在 XML 里体现,也不会报错,但上线后可能直接执行失败。建议配合 sqlcheck 或人工 review 关键 SQL。











