Navicat SQL格式化失效主因是缓存损坏、配置错误、系统快捷键冲突或编码不匹配；需依次清理Cache目录、重置sql_format.xml、修改系统Spotlight快捷键、统一设为UTF-8编码并重启软件。
Navicat 的 SQL 格式化功能突然不工作了
大概率是缓存损坏或配置项被意外修改，不是软件崩溃，也不用重装。navicat 对格式化规则的加载依赖本地缓存和用户配置文件，一旦 sql_format.xml 或缓存目录出问题，ctrl+shift+f 就会静默失效——按了没反应，也不报错。
常见错误现象：Ctrl+Shift+F 无响应；右键菜单里“格式化 SQL”变灰；已保存的格式化偏好（如缩进用空格还是 Tab）全部回退到默认。
- 先检查是否误关了功能：进入
工具 → 选项 → SQL 编辑器 → 格式化，确认启用 SQL 格式化打钩 - 重点清缓存：关闭 Navicat，删除
~/.navicat64/Cache/（macOS/Linux）或%APPDATA%\PremierSoft\Navicat\Cache\（Windows）整个文件夹 - 若仍无效，再重置格式化配置：找到并删掉
sql_format.xml（通常在同级Profile或Settings目录下），重启后会生成新默认配置
重置后缩进或关键字大小写不对
Navicat 不读取全局 SQL 风格规范，它只认自己那套 XML 规则。重置后恢复的是最保守的默认值：比如关键字全大写、缩进 2 空格、每个子句换行——这和你习惯的 lowercase keywords + 4-space indent 冲突。
使用场景：团队统一用小写关键字 + 4 空格，但重置后所有新格式化都变大写 + 2 空格，手动调一次不顶用，下次打开又回退。
- 别在 GUI 里点点点调完就以为生效了——改完必须点
确定，且要确保没勾选仅对当前连接生效 -
sql_format.xml是文本文件，可直接编辑：搜索<keyword_case></keyword_case>改成lower，<indent_size></indent_size>改成4 - 注意 Windows 下该文件可能被系统设为“只读”，删前右键属性取消勾选
Mac 上格式化快捷键 Ctrl+Shift+F 被系统占用了
macOS 默认把 Ctrl+Shift+F 绑定为“聚焦搜索”，Navicat 抢不到这个组合键，按了等于没按——这是真·无声失效，连日志都不记。
性能影响没有，但体验断层：你在 Windows 用得好好的，切 Mac 就废，容易以为是 Bug。
- 进系统设置 → 键盘 → 快捷键 → Spotlight，把
显示 Spotlight 搜索的快捷键改成别的，比如Cmd+Space（本来就是） - 或者改 Navicat 自己的快捷键：
工具 → 自定义快捷方式 → SQL 编辑器 → 格式化 SQL，设成Cmd+Shift+F更符合 Mac 习惯 - 改完必须重启 Navicat，热加载不识别新快捷键绑定
格式化后中文注释乱码或错位
本质是字符编码解析失败。Navicat 格式化器内部用 UTF-8 解析 SQL，但如果你的 SQL 文件/查询窗口本身是 GBK 编码（尤其从旧版客户端粘贴过来的），它会把中文当乱字处理，导致注释吞掉、换行错乱、甚至关键字被截断。
兼容性影响明显：同一段 SQL，在 Navicat 16 和 17 表现不同，17 对非 UTF-8 输入更敏感。
- 粘贴前先确认源内容编码：Sublime / VS Code 右下角看编码，如果不是
UTF-8，转码后再粘 - Navicat 里新建查询窗口时，默认编码由
工具 → 选项 → 环境 → 默认编码控制，务必设为UTF-8 - 已有乱码窗口无法挽救，只能复制内容 → 新建 UTF-8 窗口 → 粘贴 → 再格式化
sql_format.xml 不重启，或 macOS 下没关系统 Spotlight 快捷键。
