必须安装clarkyu.sql-beautify插件并手动将语言模式设为SQL或HQL，使用Alt+Shift+F（整文件）或Alt+Shift+L（仅DDL）格式化，确保括号闭合且无语法错误。
VSCode 里装 Beautify 插件本身不难，但很多人装完发现按 Ctrl+Shift+I 没反应、格式化后关键词大小写乱、Hive SQL 缩进错位——问题通常不出在插件本身，而在于语言模式没切对、快捷键被覆盖、或压根没配默认 formatter。
确认你装的是哪个 Beautify 插件
VSCode 扩展市场里叫 “Beautify” 的插件有多个，最常用的是 HookyQR.beautify（老牌 JS/CSS/HTML 美化器），而专治 SQL 的是 clarkyu.sql-beautify。两者不兼容，不能混用：
- 如果你主要写 SQL/HQL（尤其是 Hive 建表语句、长查询），必须装
clarkyu.sql-beautify；搜 “SQL Beautify”，认准发布者是clarkyu - 如果同时要美化 JS/HTML，建议另装
Prettier，别指望一个插件通吃 - 装错插件后即使按
Alt+Shift+F，也只会触发 VSCode 默认 formatter（可能报错或无响应）
语言模式必须手动设为 SQL
插件不会自动识别 .sql 或 .hql 文件——VSCode 默认可能把它当 Plain Text。不切换，插件根本不会加载：
- 打开任意 SQL 文件，在编辑器右下角状态栏点击当前语言名（如
Plain Text） - 在弹出菜单中选择
SQL（Hive 用户可选HQL，部分版本支持） - 更稳妥的做法：在文件顶部加一行注释
-- @language=sql，VSCode 会据此锁定语言模式 - 检查是否生效：按
Ctrl+Shift+P输入Format Document，如果命令可用且不灰显，说明语言模式已就位
快捷键冲突与正确触发方式
clarkyu.sql-beautify 默认绑定的是 Alt+Shift+F（整文件）和 Alt+Shift+L（仅 DDL），不是通用的 Ctrl+Shift+I：
- 选中一段 SQL 后按
Alt+Shift+F：格式化选中区域（适合调试时局部美化） - 光标在 SQL 文件内，按
Alt+Shift+L：专门处理CREATE TABLE类 DDL，字段会垂直对齐、类型缩进、注释右对齐 - 如果快捷键无效，去
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts，搜索sql-beautify，确认绑定未被其他插件覆盖 - 避免全局启用 “Format on save”，否则保存时可能误触非 SQL 文件的 formatter
离线安装时路径和重启细节
内网环境手动安装容易卡在“装了但不生效”，关键在扩展目录位置和重启动作：
- Windows 路径通常是：
%USERPROFILE%\.vscode\extensions\；macOS 是：~/.vscode/extensions/；Linux 类似 - 把克隆下来的
sql-beautify文件夹整个丢进去，**不要嵌套多一层目录**（比如不能是extensions/sql-beautify/sql-beautify/） - 必须执行
Developer: Reload Window（Ctrl+Shift+P输入即可），单纯关闭再开 VSCode 不够 - 装完后打开命令面板，搜
SQL Beautify，能看到至少三个命令（Format、Format DDL、Extract DDL），才算真正就绪
最常被忽略的一点：插件对嵌套子查询的缩进依赖括号匹配，如果 SQL 里有未闭合的 ( 或引号错位，它会直接放弃格式化——不是 bug，是保护机制。先用语法检查工具扫一遍，再点美化，成功率高得多。
