Beekeeper Studio 的 SQL 格式化预设怎么创建、保存并设为默认？

Beekeeper Studio 的 SQL 格式化预设怎么创建、保存并设为默认？

【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio

在 Beekeeper Studio 中写 SQL 时，如果团队或个人对格式有固定要求（关键字大小写、缩进、换行位置等），每次手动调整都很低效。Beekeeper Studio 自带的 SQL Query Formatter 允许你基于内置预设创建一个自己命名的格式化预设，把调整过的选项保存下来，再通过配置文件把某个预设设为默认，之后右键应用即可。本文覆盖这条完整路径：打开格式化面板 → 创建新预设 → 保存预设 → 设为默认 → 用预设应用格式。

先了解内置预设

格式化面板自带 3 个预设，新预设通常会以其中一个为基础修改：

1. bk-default（默认）
2. pgFormatter
3. prettier-sql

这 3 个内置预设不能删除，但可以编辑。

打开 SQL Query Formatter

两种入口，任选其一：

• 在编辑器窗口中右键，选择Format Query → Custom...；
• 或点击Save和Run旁边的按钮。

打开后，顶部下拉框中列出所有可用预设，右侧是实时的格式化预览区，后续所有调整都通过预览确认效果。

创建一个新的格式化预设

按文档给出的步骤操作：

1. 打开 SQL Query Formatter；
2. 在下拉框中选择一个已有预设作为基础；
3. 点击预设下拉框旁边的+按钮；
4. 输入预设名称（名称必须唯一）；
5. 调整格式选项，并通过右侧预览确认结果符合预期；
6. 点击Save Preset。

一个容易忽略的点：保存预设和把格式应用到当前 SQL 是两个独立动作。文档特别注明，To apply the preset to your SQL, click Apply.——保存后还需要点击Apply，预设才会实际作用到编辑器里的查询。

保存对已有预设的修改

如果想改的是某个已存在的预设而不是新建一个，流程相同：先选基础预设、调好选项，然后不点Apply，改点Save Preset。

注意文档给出的限制：Saving doesn't automatically apply the updates，保存后仍需点击Apply才能让当前查询使用新设置。同理，只点Apply也不会把选项写回到所选预设里。

把某个预设设为默认格式化器

界面内的操作只解决“预设从哪来”，默认的格式化器则由 Beekeeper Studio 的配置系统决定。默认值出厂为bk-default，可以改成任何已保存的预设名。

修改步骤：

1. 找到 User 配置文件user.config.ini。各操作系统的位置如下（目录不存在或文件不存在时可直接新建）：

   系统	用户配置文件位置
   MacOS	~/Library/Application Support/beekeeper-studio/user.config.ini
   Linux	~/.config/beekeeper-studio/user.config.ini
   Windows	%APPDATA%\beekeeper-studio\user.config.ini

2. 在文件中加入（或修改）以下配置，把defaultFormatter设为你要使用的预设名：

   [ui.queryEditor] defaultFormatter = bk-default

   上面是文档中的示例，值需替换为你实际创建并保存的预设名。

3. 保存文件并完全重启Beekeeper Studio。配置变更需要完整重启才生效。

如果重启后默认值没有变化，按文档给出的排查顺序检查：配置文件是否放在了对应系统的正确目录；INI 语法是否正确（节名用[方括号]、=两侧留空格）；节名和配置项是否拼写正确；文件权限是否允许应用读取。

用预设格式化查询

设好默认后，随时可以用任意已保存的预设格式化当前查询：

1. 在编辑器窗口中右键；
2. 悬停到Format Query；
3. 在列表中选择你要应用的预设。

Format Query菜单会直接列出已保存的预设，无需再次打开格式化面板。格式化的结果可以直接通过预览区和编辑器中的最终排版核对。

删除不再需要的预设

1. 打开 SQL Query Formatter；
2. 在下拉框中选中要删除的预设；
3. 点击旁边的Delete Config按钮。

再次提醒：3 个内置预设（bk-default、pgFormatter、prettier-sql）无法删除，但可以编辑其选项。

相关文档

• SQL Query Formatter 说明：预设创建、保存、删除与应用的完整界面操作。
• Configuration 配置系统：三级配置加载顺序（默认 → 用户 → 管理员）、生效方式与常见不生效原因。

【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio