VS Code 内置 SQL 格式化需手动启用 sql.format.enable 并设置语言模式为 SQL；调整 sql.format.uppercaseKeywords、indentSize、joinNewLine 等配置适配团队规范；DDL/PL-SQL 支持有限，复杂语句建议用专用工具或插件。
SQL Formatter 在 VS Code 里不生效？检查 sql.format.enable 和语言模式
vs code 内置的 sql 格式化能力默认是关闭的，不是装了就自动工作。最常见的情况是点右键“格式化文档”没反应，或者按 shift+alt+f 没变化——大概率是因为当前文件没被识别为 sql，或格式化开关没开。
- 先确认右下角状态栏显示的是
SQL（不是Plain Text或MySQL等第三方插件语言），如果不是，点击它手动切换到SQL - 打开设置（
Ctrl+,），搜sql.format.enable，确保勾选；这个配置项控制内置 formatter 是否启用，关着就等于没装 - 如果用的是
.sql文件但语言模式仍是Plain Text，可在命令面板（Ctrl+Shift+P）运行Change Language Mode，选SQL
格式化后缩进错乱或关键字没大写？调整 sql.format.* 配置项
VS Code 内置 formatter 默认风格很保守：不改大小写、缩进用 2 空格、JOIN 不换行——看着“整齐”，但和多数团队规范不匹配。它不会读你心里想的“应该怎样”，得明确告诉它。
-
sql.format.uppercaseKeywords设为true才会把SELECT、FROM变大写 -
sql.format.indentSize控制缩进空格数，默认 2，设成 4 更符合常见 SQL 风格 -
sql.format.joinNewLine设为true后，每个JOIN会独占一行，避免长语句挤在一行 - 注意：这些配置只对内置 formatter 生效，和
SQLTools、Redgate SQL Prompt等插件无关
ALTER TABLE 或存储过程格式化失败？内置 formatter 对 DDL/PL-SQL 支持有限
VS Code 内置的 sql.format 主要针对标准 SELECT/INSERT/UPDATE/DELETE，遇到复杂 DDL（比如带 ADD COLUMN IF NOT EXISTS）或 PostgreSQL 的 DO $$ ... $$ 块，常直接跳过或报错 Unexpected token。
- 典型错误现象：
Format Document后部分代码没变，或弹出Failed to format document - 这不是配置问题，是能力边界——它不解析语法树，只做规则替换，碰到非标准语法就放弃
- 若必须处理 DDL 或跨方言 SQL，建议临时用在线工具如 dpriver.com/sqlformat，或装
SQLBeautify插件 - 别指望它能安全重排
CREATE OR REPLACE FUNCTION这类结构，格式化前务必手动备份
格式化快捷键没反应？查冲突、查文件关联、查保存时触发设置
明明配置都对，但按快捷键就是没反应，问题往往不在 formatter 本身，而在 VS Code 的执行链路断了。
- 运行命令面板（
Ctrl+Shift+P），输入Format Document，手动执行一次——如果成功，说明快捷键被其他插件占用了 - 检查键盘快捷键设置里，
Shift+Alt+F是否绑定到了editor.action.formatDocument，而不是某个扩展的命令 - 如果希望“保存即格式化”，要单独打开
editor.formatOnSave，且确保该设置在sql语言专属设置里也启用（点右下角齿轮图标 →Language Specific Settings→SQL） - 注意：某些远程开发场景（如 WSL 或 SSH）下，
sql.format.*配置需同步到远程环境，本地设了没用
真正麻烦的从来不是“怎么按快捷键”，而是当一段嵌套了 5 层子查询、混着 CTE 和窗口函数的 SQL 被格式化后，括号对齐了，但逻辑分组反而更难读——这时候得关掉自动格式化，手动加空行和注释。工具只负责空格和换行，语义节奏还得人来定。
