VSCode默认不开启自动换行,需手动设置editor.wordWrap;最快验证方式是按Alt+Z(Win/Linux)或Option+Z(macOS)临时切换当前文件换行状态,右下角实时显示,不修改配置。

VSCode 默认不开启自动换行,必须手动设置 editor.wordWrap 才能生效——它不是“开箱即用”的功能,且容易被语言特定设置覆盖。
怎么用快捷键临时切换当前文件的换行状态
最省事的验证方式:按 Alt + Z(Windows/Linux)或 Option + Z(macOS),立刻开启或关闭当前文件的自动换行。右下角状态栏会同步显示“换行”或“不换行”。这个操作不改配置,只影响当前编辑器标签页,适合快速对比阅读效果。
为什么改了 settings.json 还是不换行
常见原因是语言特定设置(language-specific settings)优先级更高。比如打开一个 .json 或 .md 文件时,VSCode 默认关掉它的换行;即使全局设了 "editor.wordWrap": "on",该文件仍可能不换行。
- 验证方法:打开不换行的文件 → 看右下角语言标识(如 “JSON”)→ 点击它 → 选 “Configure 'JSON' language based settings”
- 检查打开的 settings.json 片段里是否有
"editor.wordWrap": "off"这一行 - 解决办法:删掉这行,或显式改成
"editor.wordWrap": "on"
editor.wordWrap 的四个取值区别在哪
editor.wordWrap 不只是 on/off 二选一,不同值直接影响换行逻辑和适用场景:
-
off:禁用换行,必须横向滚动(默认值) -
on:强制所有行按编辑器视口宽度换行,无视内容实际长度 -
wordWrapColumn:只在达到指定列数时换行(需配合editor.wordWrapColumn数值,如 120) -
bounded:取“视口宽度”和“editor.wordWrapColumn”中较小值作为换行依据,兼顾可读性与格式一致性
推荐日常开发用 bounded + editor.wordWrapColumn 设为 120,既避免小窗口挤成一团,又防止大屏下一行过长难读。
换行后缩进错乱、对齐难看怎么办
默认换行会把折行部分顶到行首,破坏缩进视觉连贯性。加这一行配置就能修复:
"editor.wrappingIndent": "indent"
它会让换行后的子行继承上一行的缩进层级。另外注意:editor.wordWrap 是纯显示层行为,不会往文件里插真实换行符,Git diff 和保存内容完全不受影响——这点常被误以为“改了源码”,其实只是眼睛舒服了而已。


















