必须启用数据库工具和 sql 插件并正确配置 sql 方言（如 mysql、postgresql），否则 goland 不会触发 sql 格式化；默认 generic sql 无效，且需手动开启 wrap every statement、align assignments 等关键选项才能实现结构化美化。

SQL代码美化必须开数据库插件

GoLand 默认不启用 SQL 格式化能力，哪怕你写了 SELECT * FROM users，按 Ctrl+Alt+L 也不会自动换行或大写关键字。根本原因是：数据库工具和 SQL 插件未激活，格式化器压根没加载。

• 打开 Settings → Plugins（macOS 是 Cmd+, → Plugins）
• 搜索 Database Tools and SQL，确保它已勾选并启用（默认已装，但可能被手动禁用）
• 重启 GoLand 或点击右上角 Reload plugin

不走这一步，后面所有设置都无效——IDE 会静默忽略 SQL 文件的格式化请求。

SQL方言必须匹配实际数据库

GoLand 的 SQL 格式化器依赖方言（dialect）驱动语法解析。选错方言会导致关键字识别失败、括号配对错误、甚至把 JSON_EXTRACT 当普通标识符处理。

• 进入 Settings → Editor → Code Style → SQL
• 在 <sql_dialect></sql_dialect> 下拉框中，**不要选 Generic SQL**，要选你真实使用的数据库类型（如 MySQL、PostgreSQL、SQLite）
• 如果项目混用多种数据库（比如同时连 MySQL 和 PG），优先按主库选；次要 SQL 文件可右键 → Change dialect 单独指定

常见坑：MySQL 方言下 IFNULL() 能正确识别，PostgreSQL 下则会把它当普通函数名，缩进逻辑错乱。

关键格式化选项要手动调

默认设置只做基础换行，对可读性提升有限。真正让 SQL “一眼看清结构”，得调这几个核心开关：

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• Wrap every statement：强制每条语句独占一行（否则 SELECT ... FROM ... WHERE ... 可能挤在同一行）
• Align assignments 和 Align expressions：让 := 和 = 对齐，列别名、条件表达式更易扫读
• Put new line around semicolon：分号独立成行，尤其适合多语句脚本（如 migration 文件）
• Hard wrap at N columns：在 Editor → Code Style → General 里设为 100，避免长 JOIN 行撑爆编辑器

注意：Keep blank lines in code 建议设为 1，空行太多反而干扰视觉节奏；设为 0 则会删掉你手动加的逻辑分隔空行。

粘贴SQL后不自动美化？关掉 Smart Keys

很多人复制一段 SQL 粘贴进 .sql 文件，发现没触发格式化——其实是 GoLand 的 “智能粘贴” 功能在捣鬼。

• 进 Settings → Editor → General → Smart Keys
• 取消勾选 Reformat on paste
• 改用显式触发：Ctrl+Alt+L（Windows/Linux）或 Cmd+Option+L（macOS）

留着这个选项反而危险：它只做简单缩进，不走 SQL 专用解析器，遇到嵌套子查询或带注释的 SQL 会格式错乱。真要自动，不如用 Save Actions 插件配“保存时格式化”，更可控。

最常被忽略的是方言和插件联动——开了插件但选错 dialect，或者开了 dialect 却没开插件，效果都等于零。格式化不是“有就行”，而是“对了才起效”。