SQL语法高亮不生效是因文件未关联SQL语言模式，需手动切换或永久绑定.sql后缀；补全缺失源于SQLTools未配置有效数据库连接；command not found错误通常因插件未重启加载；格式化异常多由插件冲突或编码非UTF-8（无BOM）导致。
SQL语法高亮不生效，SQL 语言模式没选对
Sublime Text 默认不自动识别 .sql 文件为 SQL 语言，常表现为关键字无颜色、注释不斜体、缩进错乱。这不是插件问题，而是文件关联没设好。
手动切换语言模式：打开 SQL 文件 → 点击右下角当前语言名（如 Plain Text）→ 在弹出菜单中选择 SQL；更彻底的做法是：点击 View → Syntax → SQL → SQL，确保选中的是顶层的 SQL，而非 MySQL 或 PL/SQL 等子类（它们自带不同规则，但默认不启用高亮扩展）。
永久绑定后缀：在菜单栏点击 View → Syntax → Open all with current extension as… → SQL，这样所有 .sql 文件下次都会自动用 SQL 模式打开。
关键词补全和函数提示缺失，SQLTools 插件没配连接信息
SQLTools 是 Sublime 上少数支持实时数据库感知补全的插件，但它不会“开箱即用”——必须先配置一个有效的数据库连接，否则 SELECT 后敲空格，不会弹出表名或字段建议。
安装后需做三件事：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入SQLTools: New Connection创建连接 - 填写 host、port、database、username、password；注意
driver必须选对（如 PostgreSQL 选postgres，MySQL 选mysql） - 保存后，右键 SQL 文件 →
SQLTools: Connect to…选刚建的连接；只有状态栏显示绿色Connected，补全才真正激活
常见失败点：host 写成 localhost 却没开本地服务；port 错误（PostgreSQL 默认 5432，MySQL 默认 3306）；密码含特殊字符未用引号包裹（配置文件里要加单引号）。
执行 SQL 报错 command not found: sqltools_exec，插件命令未加载
这个错误说明 SQLTools 的核心命令没注册成功，通常发生在插件安装后未重启 Sublime，或插件被禁用。
检查步骤：
- 打开
Preferences → Package Settings → SQLTools → Settings，确认内容不是空或全是注释；如果为空，复制默认配置里的"connections": []等基础结构进去再保存 - 打开
Preferences → Package Control → Disable Package，确认SQLTools不在禁用列表里 - 重启 Sublime Text —— 很多插件的命令只在启动时扫描注册，热重装不触发
若仍报错，可临时用 Ctrl+` 打开控制台，输入 sublime.log_commands(True)，再尝试执行 SQL，看控制台是否输出 command: sqltools_exec；没输出就说明命令根本没加载。
写长 SQL 时格式混乱，SQLBeautifier 和 SublimeCodeIntel 冲突
想用 SQLBeautifier 格式化语句，但一按快捷键就卡住或缩进全崩，大概率是它和 SublimeCodeIntel（或其他基于 Python 的智能插件）共存时抢了语法解析权。
稳妥做法是停用冲突插件，改用轻量替代：
- 卸载
SublimeCodeIntel，改用SQLTools自带的格式化（右键 →SQLTools: Format Query） - 或安装
SqlFormat插件（基于开源sqlparse），它不依赖后台服务，响应更快 - 设置快捷键时避开
Ctrl+Shift+F（常被其他插件占用），比如改成Ctrl+Alt+F，并在Preferences → Key Bindings中确认无重复
注意：SQLBeautifier 依赖 Java 运行环境，若系统没装 JDK 或 JAVA_HOME 未配置，也会静默失败——此时控制台无报错，但格式化无效。
最易被忽略的一点：SQL 文件编码必须是 UTF-8（无 BOM）。一旦文件以 GBK 或 UTF-8 with BOM 保存，SQLTools 连接可能建立成功，但查询返回乱码、字段名识别失败，甚至补全直接消失——检查方式是打开文件 → 看右下角编码名，不是 UTF-8 就点它转成 Convert to UTF-8，再重新保存。
