alt+z(windows/linux)或option+z(macos)是vscode中切换自动换行的默认快捷键,仅在editor.wordwrap设为"auto"或"off"时有效;若设为"on"或"bounded"则快捷键失效,需手动修改配置。

自动换行开关在哪?别找菜单,直接按快捷键
VSCode 里开启/关闭自动换行根本不用点菜单或改设置——Alt+Z(Windows/Linux)或 Option+Z(macOS)就是唯一、默认、全局生效的快捷键。它切换的是当前编辑器的 editor.wordWrap 状态,不是某个文件专属,也不是临时预览效果。
为什么有时按了没反应?检查这三件事
常见“按了没用”基本就卡在这几个地方:
-
editor.wordWrap被设成了"off"或"on"的硬编码值,覆盖了快捷键行为;打开settings.json检查有没有这行,删掉或改成"auto" - 当前文件类型被语言特定设置覆盖了,比如在
settings.json里写了"[javascript]": { "editor.wordWrap": "bounded" },那Alt+Z就只影响通用设置,不触碰这个语言规则 - 快捷键被插件劫持了,比如某些 Vim 插件会重映射
Alt+Z;打开Keyboard Shortcuts(Ctrl+K Ctrl+S),搜editor.action.toggleWordWrap,确认绑定没被改
想让所有文件默认开启自动换行?别只靠快捷键
快捷键是临时开关,真要“默认开启”,得改配置:
- 全局生效:在
settings.json加"editor.wordWrap": "auto"(推荐,响应窗口宽度变化) - 只对某类文件生效:用语言专属设置,比如
"[markdown]": { "editor.wordWrap": "on" },注意"on"是强制换行,不随编辑器宽度调整 - 避免和快捷键冲突:别设成
"off",否则Alt+Z第一次按会变成"on",第二次才到"auto",逻辑变绕
换行模式差异直接影响阅读体验
"off"、"on"、"auto"、"bounded" 行为完全不同,选错会白按快捷键:
-
"off":永远不换行,长行水平滚动——适合代码逻辑链,不适合文档类文本 -
"on":强制换行,无视编辑器宽度,可能切在单词中间——适合纯文本笔记,但写代码容易误读 -
"auto":默认值,只在视口宽度不够时换行,且尽量在空格/标点处断开——兼顾代码和文档,Alt+Z切换的就是这个和"off" -
"bounded":加了个最大列宽限制(默认 80),超过才换行——适合写注释或 README,但需额外配editor.wordWrapColumn
真正容易被忽略的是:快捷键只在 "auto" 和 "off" 之间切换,如果你手动设成了 "on" 或 "bounded",Alt+Z 不会把你带回去,得自己调回来。











