Dbeaver SQL美化器使用指南
DBeaver 自带强大的 SQL 美化（格式化）功能，一键排版、可深度自定义，也能集成外部美化工具。
一、快速使用（一键美化）
- 快捷键（最常用）
- Windows/Linux：Ctrl+Shift+F
- macOS：Cmd+Shift+F
临时回退（刚美化完想撤销）——立即按Ctrl+Z（撤销），可以恢复到美化前的状态。
- 右键菜单选中 SQL → 右键 →Format → Format SQL
- 菜单栏选中 SQL →SQL → Format → Format SQL
二、内置美化配置（自定义规则）
打开设置：
- Windows/Linux：Window → Preferences
- macOS：DBeaver → Preferences路径：Editors → SQL Editor → SQL Formatting
核心配置项（推荐）
表格
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| Keyword case | UPPER | 关键字大写（SELECT/FROM/WHERE） |
| Indent size | 4 | 缩进 4 个空格 |
| Use spaces | 勾选 | 用空格代替制表符 |
| Line breaks | 子句独立换行 | FROM/WHERE/GROUP BY 各起一行 |
| Wrap after parentheses | always | 括号内内容换行对齐 |
其他实用功能
- 大小写转换：选中 → 右键 → Format → To Upper/Lower Case
- 注释：行注释 Ctrl+/，块注释 Ctrl+Shift+/
- 保存自动格式化：勾选Save actions → Format SQL on save
三、美化效果对比
格式化前：
sql
select u.id,u.name from users u left join orders o on u.id=o.user_id where u.status='active'格式化后（按推荐配置）：
sql
SELECT u.id, u.name FROM users u LEFT JOIN orders o ON u.id = o.user_id WHERE u.status = 'active'四、高级：集成外部美化工具（如 sql-formatter）
内置不满足时，可集成 Node.js 版 sql-formatter（支持更多方言）。
- 安装 Node.js 与工具：
bash
运行
npm install -g sql-formatter- DBeaver 设置：
- 进入 SQL Formatting → 勾选Use external formatter
- Command：
node C:\Users\你的用户\AppData\Roaming\npm\node_modules\sql-formatter\bin\sql-formatter.js --dialect mysql（路径按实际调整）
- 保存后，快捷键 Ctrl+Shift+F 会调用外部工具美化。
五、常见问题
- 快捷键无效：检查是否被其他软件占用，或在 Preferences → Keys 搜索 Format SQL 重置绑定。
- 格式化乱：确认 SQL 语法无错，或切换到 Standard 内置格式化器。