VSCode默认不对SQL文件自动换行，需在settings.json中为[sql]语言模式显式配置"editor.wordWrap": "on"并设"editor.wordWrapColumn": 120，同时配合SQL Formatter插件启用selectListItemsOnSeparateLines等选项提升可读性。
VSCode 默认不给 SQL 语句自动换行，写 SELECT 带十几列、嵌套子查询或多个 JOIN 时，一行拖到屏幕右边根本看不清逻辑——这不是你代码写得差，是编辑器没配对。
SQL 文件默认不启用自动换行
VSCode 对 .sql 文件默认使用 plaintext 或 sql 语言模式，但这两者都不开启软换行（word wrap），哪怕你开了全局 "editor.wordWrap": "on"，也常因语言模式覆盖而失效。
- 检查当前语言模式：右下角看是否显示
SQL，不是Plain Text；若不对，点它 → 选择SQL - 确认配置生效：在设置里搜
word wrap，确保Editor: Word Wrap设为on或bounded（后者更可控） - 关键补丁：在
settings.json中显式为 SQL 启用，避免被其他插件覆盖："[sql]": {<br> "editor.wordWrap": "on",<br> "editor.wordWrapColumn": 120<br>}
长 SELECT 列表手动换行的合理格式
自动换行只是视觉辅助，真正提升可读性的是结构化换行——尤其对 SELECT 字段列表。VSCode 不会自动帮你拆开，但可以靠格式化插件+约定来强制对齐。
- 推荐用
SQL Formatter（作者adpyke）插件，配sql-formatter.config.json：{<br> "language": "postgresql",<br> "indent": " ",<br> "selectListItemsOnSeparateLines": true,<br> "joinClauseOnNewLine": true<br>} - 效果对比：
原始：SELECT id, name, email, created_at, updated_at FROM users WHERE status = 'active';
格式化后：SELECT<br> id,<br> name,<br> email,<br> created_at,<br> updated_at<br>FROM users<br>WHERE status = 'active';
- 注意：
selectListItemsOnSeparateLines在 MySQL 模式下可能不生效，换用postgres或generic模式更稳
WHERE 条件多时别堆在一行
多个 AND/OR 条件挤在一起，容易漏括号、错逻辑优先级。VSCode 本身不解析 SQL 语义，但格式化工具能按运算符切行。
- 手动换行位置有讲究：每个
AND前换行，且缩进一致，比如：WHERE<br> status = 'active'<br> AND deleted_at IS NULL<br> AND (category = 'A' OR category = 'B')<br> AND created_at >= '2024-01-01'
- 避免在括号中间断行，如
(a = 1 AND b = 2换行再写OR c = 3)—— 容易误删右括号 - 如果用了
SQLTools插件，它的「Format Document」快捷键（Shift+Alt+F）默认不处理换行逻辑，需配合上述 formatter 配置才有效
真正麻烦的不是换行本身，而是不同数据库方言对空格和换行的容忍度差异——PostgreSQL 看起来宽松，但某些嵌套 CTE 或 JSON 函数里多一个换行就报错；MySQL 5.7 对 GROUP BY 后换行敏感。格式化前先确认目标数据库版本和严格模式是否开启。
