选中SQL代码后按Ctrl+K Ctrl+F可格式化选区，而非Shift+Alt+F；需确保语言模式为SQL、安装支持选区格式化的插件（如cdsama.sql-formatter）、并正确绑定默认formatter，三者缺一不可。
选中SQL代码后按 Ctrl+K Ctrl+F 就能格式化，不是 Shift+Alt+F
VSCode 默认不把整个文件当 SQL 处理，Shift+Alt+F 是「格式化整个文档」，但你只想格式化当前选中的几行查询（比如 WHERE 子句或嵌套子查询），就得用 Ctrl+K Ctrl+F（Windows/Linux）或 Cmd+K Cmd+F（macOS）。这个快捷键只作用于高亮选中的文本块，不会动其他部分。
常见错误现象：选中一段 SQL 按 Shift+Alt+F 没反应——大概率是因为语言模式没切对，或者插件没设为默认 formatter；但即使配好了，它仍会格式化整文件，不是你想要的「局部整理」。
- 确认当前文件语言模式是
SQL（右下角显示，不是Plain Text） - 确保已安装并设为默认 formatter 的插件支持「选区格式化」（
cdsama.sql-formatter、adpyke.vscode-sql-formatter和sql-beautify都支持） - 如果
Ctrl+K Ctrl+F无效，检查是否被其他插件劫持了快捷键（比如某些终端或 Git 插件会覆盖Ctrl+K组合）
SQLTools 连接数据库后，Ctrl+Alt+X 执行选中语句，但格式化要另按快捷键
SQLTools 提供执行能力，但它本身不负责格式化。你写完一段带缩进混乱、逗号错位的查询，直接 Ctrl+Alt+X 能跑，但结果可读性差；想边调边修，得先格式化再执行。
实操建议：
-
Ctrl+K Ctrl+F格式化选中内容 →Ctrl+Alt+X执行 → 看结果 → 修改 → 再格式化，形成闭环 - 多语句脚本里，SQLTools 默认只执行光标所在分号分隔的语句块；
Ctrl+K Ctrl+F也只处理你选中的那块，不会跨分号乱动 - 别指望执行前自动格式化——SQLTools 没这个开关，必须手动触发
格式化后关键字变小写？查插件配置项 uppercase，不是 VSCode 全局设置
不同插件默认风格差异极大：sql-beautify 默认开启 "sql-beautify.uppercase": true，而 vscode-sql-formatter 默认小写且不暴露该配置。你看到 SELECT 变成 select，不是 VSCode 设置错了，是插件自己的行为。
解决路径很窄：
- 打开命令面板（
Ctrl+Shift+P），运行Preferences: Configure Language Specific Settings→ 选SQL - 在弹出的
settings.json片段里加对应字段，例如："sql-beautify.uppercase": true或"sqlformat.uppercase": true（取决于你装的是哪个插件） - 注意大小写和连字符：插件 ID 是
sql-beautify，配置前缀就是sql-beautify.，写成sqlbeautify或sql_beautify都无效 - 改完保存，重开 .sql 文件生效；改配置不重启 VSCode，但得重新加载该文件
调试时频繁修改 SQL，editor.formatOnSave 开关要慎用
开发阶段常边写边试，临时加个 AND id = 123、删掉一个 JOIN，这些改动往往没空格、没换行。如果开了 "editor.formatOnSave": true，每次保存都会重排整个语句，反而干扰调试节奏——尤其是你刚手动对齐了某一行用于对比，保存后全乱了。
更稳妥的做法：
- 关掉
editor.formatOnSave，只在最终提交前手动按Ctrl+K Ctrl+F整理一次 - 或者用
editor.formatOnType（输入时实时格式化），但多数 SQL 插件不支持该模式，容易卡顿或误触发 - 复杂脚本建议拆成多个小 .sql 文件，每个专注一个逻辑单元，降低单次格式化影响范围
真正容易被忽略的是：语言模式切换和 formatter 绑定必须同时生效，缺一不可；而「选中格式化」这件事，根本不在 VSCode 默认能力范围内，全靠插件实现——插件不支持，快捷键就只是摆设。
