必须手动切语言模式为SQL，因为VSCode不自动识别.sql或.hql文件，右下角常显示Plain Text；快捷键仅在SQL语言模式下生效，否则静默失败。
SQL Beautify 插件为什么必须手动切语言模式为 SQL
VSCode 不会自动识别 .sql 文件的语言模式——哪怕文件后缀是 .sql，右下角仍可能显示 Plain Text。插件的快捷键（如 Alt+Shift+F）只在当前语言模式匹配时才绑定生效。一旦状态栏显示错误，所有格式化操作都会静默失败，没有报错、也不提示。
常见现象：按了快捷键没反应，查设置全开，重装插件也没用。根本原因就是这一步被跳过。
- 点击右下角语言标识（如
Plain Text或MySQL），选择SQL（注意不是MySQL、PostgreSQL等子类） - 若项目中大量
.hql文件，建议在.vscode/settings.json中加配置："files.associations": {"*.hql": "sql"} - 临时验证是否生效：打开一个 SQL 片段，按
Ctrl+Shift+P输入Format Document，看命令是否可选且执行成功
DDL 美化（Alt+Shift+L）和普通格式化（Alt+Shift+F）不能混用
Alt+Shift+L 是 Hive DDL 专用通道，它会重排字段顺序、对齐注释、标准化 PARTITIONED BY 和 STORED AS 的缩进层级；而 Alt+Shift+F 只做通用语法树级换行与空格处理，对 DDL 结构毫无感知。
误用后果：对建表语句用 F 键，字段挤成一行、注释错位、分区定义被拆到多行但不对齐，反而更难读。
- Hive 建表/修改表语句 → 一定用
Alt+Shift+L - SELECT/INSERT/UPDATE/CTE 查询块 → 用
Alt+Shift+F - 混合文件（如含 DDL + 查询的脚本）→ 先选中对应代码块再触发，别全选
sql.beautify.keywordCase 配置不生效的三个真实原因
这个配置项控制关键字大小写（SELECT vs select），但它不是全局开关，而是依赖插件底层解析器能否识别语句类型。HiveSQL 支持最好，其他方言容易 fallback 到默认小写。
- 配置写在用户 settings 而非工作区 settings：插件优先读取 workspace 级配置，用户级设置常被覆盖
- 语言模式不是
SQL：即使配置正确，插件未激活就根本不读该参数 - 语句含 Hive 特有语法（如
LATERAL VIEW、TRANSFORM）但插件版本旧：0.3.22 之前版本对复杂 Hive 关键字识别不稳定，升级到最新版再试
从 INSERT 提取 DDL（Alt+Shift+;）只适用于 HiveSQL 场景
这个功能本质是正则 + 模式匹配，不是 AST 解析。它能从 INSERT INTO table SELECT ... 中反推字段名、类型、注释，但前提是源表结构符合 Hive 元数据规范（如字段名无引号、类型用 STRING/BIGINT 等标准写法）。
遇到失败别硬试：PostgreSQL 的 INSERT ... RETURNING、MySQL 的 INSERT IGNORE 都会直接解析失败，返回空或乱码。
- 仅限 Hive / SparkSQL 环境使用
- 输入语句必须是完整
INSERT INTO table_name SELECT ...形式，不能带 CTE 或子查询嵌套 - 字段别名不能用双引号包裹（
"col_name"→ 不支持；col_name→ 支持）
