Atom编辑器配合atom-beautify插件格式化SQL代码

先说几个核心判断：Atom编辑器里处理SQL格式化，其实是个容易踩坑的事情。不少朋友装上atom-beautify后，满怀期待地按下Ctrl+Alt+B，结果发现对.sql文件完全没反应。别急，这不是插件坏了，而是它压根没把SQL纳入支持范围。

atom-beautify 默认不支持 SQL 格式化

你猜怎么着？atom-beautify 虽然能识别 .sql 文件类型，但内核里压根儿没绑定任何 SQL 美化工具。官方语言列表里明确不包含 SQL，所以再折腾快捷键绑定也无济于事。

比较常见的坑有这么几个：

• 右下角明明显示的是 SQL 语法，可即便勾选了 beautify_on_sa ve，依然没反应。
• 右键菜单里压根没有 Beautify 选项，仿佛插件不认识这个文件。
• 即便你在终端里能跑 sql-formatter --version，但Atom里就是不触发。

更扎心的是，如果你不信邪，手动跑到 atom-beautify 的 Settings → Languages → SQL 下勾上 beautify_on_sa ve，它只会静默跳过，既不报错也不留日志——安静得令人心疼。它不会自动寻找或调用 sql-formatter、pg_format 或 sqlparse 这类外部工具。

SQL 格式化必须换插件或手动配置引擎

那到底怎么解决问题？其实就两条路，但只有一条走得通。

最推荐的做法：直接换专用插件。

• 先卸载或禁用 atom-beautify 对 SQL 的干扰：Settings → atom-beautify → Languages → SQL → 取消勾选所有选项。
• 然后安装独立插件 sql-formatter：Settings → Install → 搜“sql-formatter” → Install。
• 这个插件默认绑定 Ctrl+Alt+L（Windows/Linux）或 Cmd+Alt+L（macOS），选中 SQL 片段或全文件都能格式化。
• 不过要提醒一句：它不支持保存时自动格式化，只能手动触发。如果你非要这个功能，得配合 atom-autocomplete-sql 或写自定义 keymap。

另一条路？基本走不通。 想给 atom-beautify 硬塞一个 SQL 引擎？它的 SQL 配置项里压根没有 beautifier 下拉菜单，也没法指定外部命令路径。强行改 config.cson？会触发校验失败或被直接忽略。

为什么不用 prettier-atom 处理 SQL

有人可能会问：那 prettier-atom 行不行？答案也很干脆：不行。Prettier 官方至今没有提供 SQL 解析器，支持的语言列表里压根没有 sql 或 pgsql。

那些说“prettier 支持 SQL”的说法，多半是混淆了以下几种情况：

• 有人把 prettier-plugin-sql（一个第三方实验性插件）当成了官方能力，可这个插件跟 prettier-atom 不兼容，Atom 根本加载不了。
• 有人把数据库 CLI 工具（比如 psql -f script.sql）的输出当成编辑器内格式化效果。
• 还有人是在 Webpack/Vite 构建流程里跑 sql-formatter CLI，那和 Atom 编辑器毫无关系。

一句话总结：别在 prettier-atom 和 atom-beautify 这两个插件上浪费调试时间，它们都不能解决 Atom 里的 SQL 格式化问题。

SQL 文件识别与编码容易被忽略

即便你装好了 sql-formatter，也可能碰到快捷键无效或只格式化一半的怪事。问题往往出在基础层。

• 先检查右下角的 grammar 是否为 SQL。如果显示的是 Plain text，手动点一下改成 SQL。另外，Atom 对 .sql 后缀的文件识别正常，但像 Dockerfile 里嵌入的 SQL 块或无后缀脚本，它是不认的。
• 确认文件编码是 UTF-8。如果是 GBK 或 ISO-8859-1，sql-formatter 解析时会直接失败——光标乱跳或格式化后出现乱码字符。
• sql-formatter 默认使用 postgres 语法风格。如果你写的是 MySQL 或 T-SQL，需要在插件设置里切换 dialect 选项，否则关键字大小写、引号风格都会出错。

最隐蔽的一个坑：如果你的项目目录里有超大体积的 SQL 文件（超过 10MB），Atom 启动时 sql-formatter 可能会卡住主线程，导致界面直接冻结。这时候建议关闭自动语法高亮，或者把大文件拆分处理。