SqlBeautifier插件在2026年4月的Sublime Text中根本不存在于Package Control官方仓库，所有相关教程均已过时；推荐使用SQLTools+sqlformat组合，需全局安装sqlparse、正确设置语法为SQL、配置formatter_args为["--reindent"]并验证环境。

SqlBeautifier 插件在当前 Sublime Text（2026 年 4 月）中无法通过 Package Control 正常安装或使用——不是你操作错了，是它根本不在官方仓库里，也不被现代 Sublime 支持。

---

为什么搜不到 SqlBeautifier？

• Package Control 官方仓库中没有名为 SqlBeautifier、SQLBeautifier_sublime 或类似变体的有效包
• 所有声称“搜这个名就能装”的教程，要么基于已下架的旧版仓库，要么把 GitHub 上长期未维护（最后更新早于 2022 年）、无构建元数据的 fork 项目当真了
• 即使手动 git clone 到 Packages/ 目录，Sublime 启动时若检测到依赖缺失（如 sqlparse 未全局安装）或 Python 版本不匹配，会直接忽略该插件，不报错、不提示、不加载
• 快捷键 Ctrl+K Ctrl+F 在新版本 Sublime 中已被默认绑定给“折叠代码块”，冲突后按了也没反应

---

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

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

• 先确保系统级 Python 已安装 sqlparse：

  pip install sqlparse

  ✅ 验证方式：终端运行 python -m sqlparse --help 能打印帮助即成功 ❌ 不要用 pip3 install sqlparse 后只在虚拟环境里，Sublime 默认调用的是系统 python

• 通过 Package Control 安装 SQLTools（注意：不是 SQLTools Core 单独装，它会自动带依赖）

• 重启 Sublime，右下角状态栏必须显示 SQL（不是 MySQL、Plain text）；点它手动切到 SQL 语法，否则格式化命令压根不激活

• 打开 Preferences → Package Settings → SQLTools → Settings，填入用户设置：

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

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

---

SQLTools 按快捷键没反应？先查这三处硬性条件

• 当前文件语法 scope 是 SQL 吗？右下角点开确认，不是就手动选
• sqlparse 是否全局可用？Sublime 控制台（Ctrl+`）里执行 import sqlparse 看是否报错
• 快捷键是否被占用？默认是 Ctrl+Shift+Q（Windows/Linux）或 Cmd+Shift+Q（macOS），不是 Ctrl+K Ctrl+F

---

如果非要试 SqlBeautifier 手动安装，这些坑必踩

• 手动克隆的目录名必须是 SqlBeautifier（大小写敏感），且放在 Packages/ 下一级，不能套子文件夹
• 插件配置里 command 字段要写对：Windows 填 "python"，macOS/Linux 填 "python3"，不能直接写 "sqlparse"
• 它的 "keyword_case": "upper" 实际只影响 SELECT/FROM 等少数词，AS、ON、WHERE 依然小写——这是 sqlparse 库本身的限制，改配置没用
• 选中文本格式化失效？大概率是因为当前 buffer 的 scope 不是 source.sql，比如你在 Python 文件里写了 SQL 字符串，得先手动切语法

真正的难点从来不是“怎么装”，而是Sublime 加载插件时静默失败、不报错、不提醒。所有看似“配置不对”的问题，八成是环境没对齐，或者插件根本没活过来。