要让.sql文件一打开就有高亮，需手动切换右下角语法为SQL（非MySQL/PL/SQL），再右键标签选“Apply to All Files with Same Extension”；若无SQL选项，则用Package Control安装sublimelsp的SQL包。
Sublime Text 不能直接连接或执行 SQL —— 所有“运行”“补全”“格式化”能力都依赖外部 CLI 工具（如 mysql、psql）或插件中转，配置失败 90% 是因为本地命令行工具没就绪，而不是 Sublime 设置错了。
怎么让 .sql 文件一打开就有高亮？
不是插件没装，是 Sublime 根本没把文件当 SQL 看。右下角显示 Plain Text 或 MySQL 就说明识别路径错了。
- 手动切换：打开任意
.sql文件 → 点右下角当前语法名 → 选SQL（注意不是MySQL或PL/SQL，那是子集，不兼容标准语法） - 永久绑定：切换后右键文件标签 →
Set Syntax: SQL→ 再点Apply to All Files with Same Extension - 如果列表里压根没有
SQL选项，说明缺核心语法包：用Package Control: Install Package安装SQL（作者sublimelsp，别装错成同名旧包） - 验证是否生效：写
SELECT * FROM users;，关键字应立刻变蓝/粗体；否则检查Packages/SQL/SQL.tmLanguage是否存在
按 Ctrl+Enter 没反应？Build System 配错了
Sublime 不执行 SQL，只是调用你系统里的 mysql 或 psql。快捷键失效，99% 是因为命令根本跑不起来。
- 先在终端确认：
mysql --version或psql --version必须能输出版本号；Windows 用户特别注意 PATH 是否包含mysql.exe所在目录（如C:Program FilesMySQLMySQL Server 8.0in） - 新建 Build System：
Tools > Build System > New Build System，填入（以 MySQL 为例）：{ "cmd": ["mysql", "-u", "root", "-p", "testdb", "-e", "source $file"], "selector": "source.sql", "shell": true } -
$file是当前文件绝对路径，别写成$file_path或漏引号；shell: true在 Windows 下必须加，否则找不到命令 - 保存为
MySQL.sublime-build，然后在Tools > Build System中选它；再按Ctrl+B（不是Ctrl+Enter）触发构建
SQLTools 插件连不上数据库？它根本不存连接信息
SQLTools 不是客户端，它只是个“管道”——所有连接参数（host、port、user）最终都会拼成一条 psql -h xxx -U yyy 命令去调系统 CLI。所谓“配置连接”，本质是告诉插件怎么拼这条命令。
- 安装前提：已装
Node.js（SQLTools后端用 JS 写），且对应数据库 CLI 工具（psql、mysql）已在 PATH 中 - 连接配置文件位置：
Packages/User/SQLTools/Connections.sublime-settings，内容必须是 JSON 格式，每个连接块要指定"driver"（如"postgres"）、"host"、"database"等字段 - 常见错误：
"driver": "mysql"却没装mysqlCLI；或"port"写成字符串"5432"而不是数字5432，导致静默失败 - 测试方法：在命令面板（
Ctrl+Shift+P）里运行SQLTools: Connect，看状态栏是否显示数据库名；若弹出command not found，回头检查 CLI 是否可用
格式化和补全为什么时灵时不灵？路径和 Python 环境容易串
sqlparse 或 pg_format 这类格式化器，不是装上 pip 就完事——Sublime 可能调用的是内置 Python（3.3），而你装 sqlparse 在 Python 3.9 下，结果就是按 Ctrl+Alt+F 没反应，也不报错。
- 最稳做法：用绝对路径指定格式化器，比如在
SQLTools Settings里写"sqlparse_path": "/usr/local/bin/sqlparse"（macOS/Linux）或"sqlparse_path": "C:\Python39\Scripts\sqlparse.exe"（Windows） - 补全依赖
Packages/User/SQL.sublime-completions，格式必须是 JSON 数组，每项含"trigger"和"contents"字段；放错目录（比如放到Packages/SQLTools/下）就完全不加载 - 改完设置必须重启 Sublime，否则新
.sublime-completions文件不会被扫描 - CTE 或窗口函数（如
OVER (PARTITION BY ...)）格式化错位，不是 bug，是sqlparse对复杂语法支持有限，可临时关掉reindent选项
真正卡住人的地方从来不是 Sublime 设置本身，而是你本地有没有一个能直接在终端里敲 psql -d mydb 就连上的环境。所有插件和构建系统，都只是站在这个基础之上的薄层封装——基础不牢，上面配得再花哨也没用。
