“format document”只调整语法结构（如缩进、空格、括号对齐），不控制行宽或视觉换行，故无法解决长代码行视觉溢出；真正生效的是editor.wordwrap（软换行）或格式化插件+语言专属规则（如sql字段分行、xml属性拆行、clang-format处理c++模板）。
VSCode 默认不给长代码行自动换行，光靠“格式化文档”解决不了视觉溢出问题——必须手动配 editor.wordWrap 或用插件接管换行逻辑。
为什么“Format Document”对长行没用？
VSCode 的 Format Document（默认快捷键 Shift+Alt+F）只处理语法结构（如缩进、空格、括号对齐），不控制行宽或软换行。它不会把一行 200 字符的 SELECT 拆成多行，也不会让 XML 属性自动分行——那是编辑器渲染层的事，不是格式化器的职责。
- 格式化插件（如 Prettier、XML Tools、Clang-Format）只改代码内容，不改显示方式
-
editor.wordWrap是唯一影响“视觉换行”的设置，但它只是软折叠，不改变实际换行符 - 真正提升可读性的，是“结构化换行”：比如每个 SQL 字段独占一行、每个 XML 属性独占一行——这需要格式化插件 + 显式规则
SQL 长行换行：靠 formatter 插件 + 语言专属配置
单纯开 editor.wordWrap 只能让 SELECT 语句横向折叠，但字段堆在一行仍难读。必须用 SQL Formatter 类插件（如 SQL Formatter 或 vscode-sql-formatter），并启用结构化选项：
- 在
settings.json中为[sql]语言模式添加："selectListItemsOnSeparateLines": true - MySQL 模式下该选项可能失效，建议显式设
"language": "postgresql"或"generic" - 避免依赖全局
wordWrapColumn，因为嵌套子查询、JOIN 条件长度不一，固定列数容易切错位置 - WHERE 多条件时，手动在每个
AND前换行，并保持缩进一致，比自动换行更可靠
XML 属性换行：必须用支持 splitAttributes 的插件
Red Hat 的 vscode-xml 和 XML Tools 都支持属性分行，但行为差异大：
-
vscode-xml依赖xmlTools.formatOptions.splitAttributes，设为true后，超长标签会把每个属性放单独一行 -
XML Tools需配合"wrapLineLength": 80才触发换行，且对自闭合标签（<img>）更友好 - 别混用多个 XML 格式化器，VSCode 只会调用默认的那个，冲突时以
"[xml]": { "editor.defaultFormatter": "..." }为准 - Prettier 的 XML 支持较新，需额外安装
prettier-plugin-xml，否则printWidth对属性无效
C++ 模板参数换行：Clang-Format 是唯一解
vscode-cpptools 内置格式化器完全不处理模板参数换行。想让 std::vector<:map std::shared_ptr>>>>></:map> 可读，必须走 Clang-Format 路线：
- 确认已装
clang-format≥12.0，并在设置中指定："C_Cpp.formattingProvider": "clangFormat" - 关键参数是
BreakTemplateDeclarations: Always，不是MultiLine——后者只在已有换行时才对齐，不主动拆 -
ColumnLimit设太小（如 60）会导致过度拆分，设 100–120 更平衡 - 如果项目有
.clang-format文件，优先用"C_Cpp.clang_format_style": "file"，避免 settings.json 覆盖
真正难的不是找到插件，而是搞清哪一层负责什么：格式化器改代码、编辑器渲染层管显示、语言特定规则决定怎么拆。三者不协同，再好的插件也白装。
