VSCode默认不换行，必须显式设置editor.wordWrap才生效；临时切换用Alt+Z/Option+Z，永久生效需在用户设置中设为"on"，但语言特定设置可能覆盖全局配置。
VSCode 默认不换行，必须显式设置 editor.wordWrap 才生效——这不是 bug，是设计选择；临时切换用快捷键，永久生效靠配置，但语言特定设置常会覆盖它。
按 Alt+Z / Option+Z 为什么没反应？
快捷键只对当前编辑器主区域有效，常见失效原因：
- 光标焦点在终端、搜索框、侧边栏或调试控制台里
- 当前文件语言启用了 language-specific 设置（比如打开
.json文件时，VSCode 默认设了"editor.wordWrap": "off"） - 右下角语言标识（如 “JSON”）被点击后，跳转到的语言专属配置里写了
"editor.wordWrap": "off"，优先级高于全局设置
验证方式：打开不换行的文件 → 点右下角语言标签 → 选 “Configure 'XXX' language based settings” → 检查是否有冲突配置。
让所有文件默认换行，只改 editor.wordWrap 就够了吗？
够，但必须确保改的是用户级（User）设置，且值为 "on" 或明确指定的模式。不要选 auto（等同于 off）或 inherit（易被插件或工作区覆盖）。
- 推荐操作：快捷键
Ctrl + ,（Win/Linux）或Cmd + ,（macOS）→ 搜索word wrap→ 找到Editor: Word Wrap→ 下拉选on - 或直接编辑
settings.json，加这一行："editor.wordWrap": "on" - 改完不用重启，但已打开的文件可能需手动按一次
Alt + Z刷新渲染
editor.wordWrap 的四种取值怎么选？
不同值对应完全不同的换行逻辑，不能只看名字：
-
off：不折行，强制水平滚动（适合日志分析、正则调试等需看清整行结构的场景） -
on：纯视口折行，窗口缩放时实时重排（最通用，日常写代码、读 Markdown 表格都合适） -
wordWrapColumn：严格按editor.wordWrapColumn设定的列数折行（如设为120，超 120 字符就断，适合文档注释、SQL 查询） -
bounded：取视口宽度和editor.wordWrapColumn中较小值折行（看似灵活，但窗口缩小时行为突变，实际难预测）
注意：wordWrapColumn 和 bounded 必须配合 editor.wordWrapColumn 数值才生效，单独设列数无效。
换行后缩进错位、看起来像“顶格”怎么办？
这是软折行后的默认缩进样式问题，editor.wordWrap 只控制是否折，不控制折后怎么对齐。
- 加这行配置：
"editor.wrappingIndent": "indent"，折行后子行会继承上一行缩进层级 - 如果仍不对齐，检查是否用了特殊字体（如某些等宽字体缺少软连字支持），换
Fira Code或JetBrains Mono通常能改善 - 极长行（如 base64、大段 JSON）开启换行可能导致滚动卡顿，可尝试
bounded模式缓解
最易被忽略的一点：自动换行只是视觉层渲染，不影响文件内容、Git diff、复制粘贴、格式化工具行为——它不会插入真实换行符，也不会改变任何逻辑。
