SqlBeautifier插件在Sublime Text的Package Control中根本不存在，所有相关教程均已过时或错误；推荐使用SQLTools+sqlformat组合，需正确配置语法、安装依赖并验证环境。

SqlBeautifier 插件根本不存在于当前 Sublime Text 的 Package Control 官方仓库中，所有声称能通过 Package Control: Install Package 搜索安装 SqlBeautifier 的教程，都是过时、拼错或误导信息。你装不上、点不动、快捷键无效，不是配置问题，是名字错了。

---

为什么搜不到 SqlBeautifier？

截至 2026 年 4 月，Sublime Text 官方 Package Control 中没有名为 SqlBeautifier 或 SQLBeautifier_sublime 的有效插件。GitHub 上同名仓库多为 fork 错误、已归档、或长期未维护（最后更新早于 2022 年）。Package Control 会自动过滤掉不兼容或无构建元数据的包，所以它“搜不到”是正常结果，不是你网络或操作的问题。

• 搜索 SQL Beautify、SQL Formatter 等泛称，大概率装到的是废弃插件（如 SQLFormat、SQLBeautify），它们不支持现代 SQL 语法，选中格式化常静默失败
• SqlBeautifier 的快捷键（如 Ctrl+K Ctrl+F）在新版本 Sublime 中已被其他功能占用，即使手动装上也基本无法触发
• 所谓“手动 git clone 安装”路径若没放进正确的 Packages/ 目录，或插件依赖的 Python 模块（如 sqlparse）未全局安装，Sublime 启动时直接忽略该包，不报错也不加载

---

真正可用的替代方案：用 SQLTools + sqlformat

这是目前最稳定、可调试、支持选中文本和全文件格式化的组合。它不靠玄学插件，而是调用命令行工具，出问题能立刻看到错误输出。

• 先装 Python 工具：pip install sqlparse（确认是系统级 Python，不是虚拟环境）
• 再通过 Package Control: Install Package 安装 SQLTools（注意不是 SQLTools Core 单独装，它会自动带依赖）
• 重启 Sublime，右下角状态栏必须显示 SQL（不是 MySQL 或 Plain text），否则格式化命令不激活
• 打开 Preferences → Package Settings → SQLTools → Settings，填入用户设置：

{
  "formatter": "sqlformat",
  "formatter_args": ["--reindent"],
  "format_on_save": false
}

关键点：--reindent 是唯一推荐参数；加 --keywords-upper 会导致解析崩溃，报 Unexpected keyword；sqlformat 不接受 -i 或 --indent-width 这类参数。

---

如果 SQLTools 仍不响应，检查这三处

插件装了但按 Ctrl+Shift+Q（默认格式化快捷键）没反应？别急着重装，先看这几个硬性条件是否满足：

• Sublime 必须完全退出再重开：热加载不生效，尤其 Windows 用户容易忽略这点
• 当前文件 syntax 必须设为 SQL：右下角点击语法名 → SQL（不是 MySQL、PL/SQL 或 Plain text）；也可用快捷键 Ctrl+Shift+P → 输入 Set Syntax: SQL
• 选中的 SQL 片段不能有语法硬伤：比如开头是 /* 但没闭合，或含未转义的单引号嵌套，sqlformat 会直接跳过处理，不提示、不报错、也不改动——删掉可疑注释或字符串再试

---

终极可控方案：用 Build System 直调 sqlformat

绕过插件层，把格式化变成一个可预测的命令行动作。适合经常处理大 SQL、需要精确控制参数、或团队统一风格的场景。

• 菜单 → Tools → Build System → New Build System
• 贴入以下内容（Mac/Linux 用户无需改路径；Windows 用户确保 sqlformat 在 PATH 中）：

{
  "cmd": ["sqlformat", "--reindent", "-"],
  "selector": "source.sql",
  "file_regex": "^.*$"
}

• 保存为 SQLFormat.sublime-build
• 选中 SQL → Ctrl+Shift+B → 选 SQLFormat → 回车

这个方案不依赖插件状态，不看 syntax 是否“标准”，只要 sqlformat 命令能运行，就一定有输出。缺点是不能自动替换原内容（需配合 Replace 操作），但胜在确定性高——你看到什么，就是什么。

真正的难点不在“怎么装”，而在于确认你调用的到底是哪个二进制、它跑在哪个 Python 环境、以及输入文本是否被它当作合法 SQL 解析。别让“一键美化”的预期掩盖这些底层事实。