sql文件不亮需先手动切换右下角语法为sql（非mysql/pl/sql），再右键选“apply to all files with same extension”；若无sql选项则用package control安装sublimelsp的sql包；连postgresql需验证psql命令可用、端口为5432、密码含特殊字符时用单引号包裹；格式化快捷键为ctrl+k ctrl+f；补全与执行依赖状态栏显示绿色connected。
SQL 文件不亮？先让 .sql 认出它是 SQL
Sublime 默认把 .sql 文件当 Plain Text，高亮根本不会触发。右下角点当前语言名（大概率是 Plain Text 或 MySQL），从菜单里选 SQL —— 注意不是 MySQL、PL/SQL 或 PostgreSQL，那些是子语法，自带限制，标准 SQL 高亮反而被绕过。
选完后右键文件标签 → Set Syntax: SQL → Apply to All Files with Same Extension，否则下次打开还是白板。
如果菜单里压根没 SQL 选项：
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package - 搜
SQL，认准作者是sublimelsp的那个包（别装错老版本或名字近似的） - 装完检查
Packages/SQL/SQL.tmLanguage是否存在
连不上 PostgreSQL？先验证 psql 命令能不能跑通
SQLTools 不自己连数据库，它只是拼一条 psql -h xxx -U yyy -d zzz 去调你系统的 psql。连不上，基本等于你在终端里敲这行命令也会失败。
排查顺序：
- 终端执行
psql --version，有输出才算客户端就位 -
which psql（macOS/Linux）或where psql（Windows），确认路径已加进PATH - 端口别写成
3306，PostgreSQL 默认是5432 - 密码含
$、'、"等字符时，配置里必须用单引号包住，比如'my$p@ss'
配置入口：Preferences → Package Settings → SQLTools → Settings，填的结构必须严格匹配 JSON 格式，少个逗号都会让连接失效。
格式化 SQL 别用错快捷键：Ctrl+K, Ctrl+F 不是 Ctrl+Shift+B
不同插件快捷键打架很常见。SqlBeautifier 默认用的是 Ctrl+K 然后 Ctrl+F（Windows/Linux），Mac 是 Cmd+K → Cmd+F。而很多人搜到的 Ctrl+Shift+B 是另一个叫 SQLBeautify 的旧插件，现在基本没人维护了，装了也容易冲突。
安装建议：
- 按
Ctrl+Shift+P→Package Control: Install Package→ 搜SqlBeautifier（注意大小写和拼写） - 装完不用重启，但得确保当前文件语法是
SQL，否则快捷键无效 - 想改快捷键？去
Preferences → Package Settings → SqlBeautifier → Key Bindings编辑
补全和执行功能没反应？状态栏没变绿就是没真正连上
SQLTools 的智能提示、执行查询、结果面板这些能力，全部依赖“绿色 Connected”状态。光在设置里填了连接信息不等于连上了。
必须手动激活：
- 按
Ctrl+Shift+P→SQLTools: New Connection - 右键打开的
.sql文件 →SQLTools: Connect to…→ 选你刚建的连接名 - 看 Sublime 窗口右下角状态栏：出现绿色
Connected才算生效
如果点了没反应，回头检查 psql 是否真能连：终端里直接运行配置里写的那条完整命令，比如 psql -h localhost -U postgres -d mydb，输密码看能不能进。卡在这步，插件再配十遍也没用。
