VSCode不建议全局启用自动换行，因其破坏代码层级结构、错位对象属性、干扰diff对比、终端与Debug Console无效，且语言专属设置优先级更高；应按需用Alt+Z临时开启。
VSCode 不建议全局自动换行，是因为它会干扰代码语义阅读、破坏结构对齐、且在关键视图中失效——这不是设置“没开好”，而是设计上就不该无差别启用。
为什么 editor.wordWrap 全局设为 "on" 会让链式调用和对象字面量变难读
软换行不改变缩进逻辑，只按视口宽度硬切，导致第二行直接顶格。比如这段代码：
const result = users
.filter(u => u.active)
.map(u => ({ id: u.id, name: u.name.toUpperCase() }))
.reduce((acc, u) => ({ ...acc, [u.id]: u }), {});
在窄窗口下会被切成多段，但每段都从行首开始，丢失了 .filter、.map 的层级关系。更糟的是，对象属性如果被折到下一行，会和上层 key 完全错位。
- 加
"editor.wrappingIndent": "indent"可缓解，但无法修复嵌套过深的 case（如三重箭头函数内联） - Markdown 表格、YAML 键值对、JSON Schema 注释块也会因折行错位而失去可读性
- 某些语言插件（如 Rust 的 rust-analyzer）会禁用
wordWrap，即使你全局开了，实际也不生效
diffEditor.wordWrap 默认是 "on"，但代码对比时必须关掉
Git diff 或文件对比面板里，如果开启换行，长行会被视觉截断，导致你看到的不是真实差异，而是“被折行后的假差异”。例如：
- 一行新增了 5 个字符，但因换行显示成两行，你可能误判为插入了一整行
- 删除操作发生在折行中间，Diff 面板会把前后两段都标红，掩盖真实修改点
- 对比 JSON 时，key-value 对被拆开，根本没法快速定位字段变更
正确做法是在 settings.json 中显式关闭："diffEditor.wordWrap": "off"。否则即使编辑器里开着换行，diff 视图仍会给你制造干扰。
终端、Debug Console、Output 面板完全无视 editor.wordWrap
很多人以为开了 editor.wordWrap 就能解决控制台日志溢出问题，其实 VSCode 终端压根不读这个配置。xterm.js 渲染层和编辑器渲染层完全隔离，terminal.integrated.wordWrap 这个配置项根本不存在。
- 终端输出是否换行，取决于 shell 自身（如 bash 的
stty设置）和命令行为（ls --color=always不换行，cat会随终端宽度折） - 想让
git log或npm run build输出可读？得用| fold -w $COLUMNS或| less -S，而不是调编辑器设置 - Debug Console 里的变量展开、错误堆栈，同样不会软换行；长字符串只会横向滚动
语言专属设置优先级高于全局，你以为开了其实没开
VSCode 对 .json、.md、.log 等类型默认关掉换行。你改了全局 "editor.wordWrap": "on"，打开一个 JSON 文件，右下角仍显示“不换行”——因为 [json] 语言设置里有更高优先级的 "editor.wordWrap": "off"。
- 验证方式：点击右下角语言标识（如“JSON”）→ “Configure 'JSON' language based settings”
- 修复不是删掉语言设置，而是显式覆盖：
"[json]": { "editor.wordWrap": "on" } - 但不推荐这么做：JSON 值太长时，换行反而让 key/value 关系断裂，不如用
jq格式化后再看
真正需要换行的场景很具体：写文档、读日志片段、审 Markdown —— 它们不该靠全局开关兜底，而应按需启用（Alt+Z 快捷键就是为此存在）。把“显示优化”当成“格式规范”，是多数人踩坑的起点。
