Navicat SQL格式化不生效需先开启“启用SQL格式化”开关并重启软件；格式化效果受关键字大小写、每行字段数、缩进宽度影响；可能引发hint失效、UNION隐式转换、反引号丢失等问题；批量格式化应使用sqlformat等命令行工具。
Navicat 里 SQL 格式化不生效？先检查这个配置开关
navicat 的格式化功能默认是关闭的，不是装上就能用。很多人点 ctrl+shift+f 没反应，或右键菜单里找不到「格式化」，其实只是没打开开关。
- 路径：
工具 → 选项 → SQL 编辑器 → 启用 SQL 格式化（Windows）或Navicat → 偏好设置 → SQL 编辑器 → 启用 SQL 格式化（macOS） - 勾选后必须重启 Navicat 才生效——这是最常被跳过的步骤
- 如果用了自定义快捷键，注意确认是否和系统/输入法冲突（比如中文输入法下
Ctrl+Shift+F可能被拦截）
格式化结果和你预期不一样？重点看这 3 个参数
Navicat 的格式化行为高度依赖 SQL 格式化设置 里的细节，尤其影响可读性和团队协作一致性。
-
关键字大写：勾选后SELECT、WHERE等全大写；不勾选则保持原大小写——但注意：它不会修正语法错误，只改写法 -
每行一个字段：对SELECT和JOIN子句特别关键。不勾选时长字段列表会挤成一行，可读性骤降 -
缩进宽度：建议设为4，避免和 VS Code / DBeaver 等工具混用时产生缩进混乱；设为2在嵌套子查询里容易看不清层级
为什么格式化后 SQL 执行报错？小心这些隐藏改动
Navicat 格式化不是无损操作，某些场景下会悄悄改变语义，尤其在拼接动态 SQL 或使用特殊注释时。
- 自动删除行尾空格和制表符：可能导致
/*+ USE_INDEX(t1 idx_a) */这类 hint 被截断或错位 - 重排
UNION语句顺序：若前后子查询字段类型不一致，格式化后可能暴露隐式转换问题（比如把INT和VARCHAR并列） - 对反引号
`处理不稳定：MySQL 模式下，含空格或关键字的表名如`order`，格式化有时会漏掉反引号，直接变成order导致语法错误
想批量格式化一堆 SQL 文件？别用 Navicat 自带功能
Navicat 的格式化仅支持当前编辑器窗口内文本，不支持文件夹批量处理，也不支持命令行调用。强行导出再导入效率低、易丢配置。
- 替代方案：用
sqlformatCLI 工具（Python 实现），支持 MySQL/PostgreSQL/Oracle 等方言，命令行可集成到脚本中 - 示例：
sqlformat --reindent --keyword-case=upper query.sql - 注意 Navicat 导出的 SQL 常含
DELIMITER和存储过程体，这类结构sqlformat默认不识别，需加--dialect=mysql参数并手动拆分
真正难的不是怎么点那个按钮，而是格式化前得判断这段 SQL 是给人看的、还是给程序拼的——前者靠 Navicat，后者得换工具链。
