Alt+Z 是 VSCode 自动换行开关,仅在激活的文本编辑器中生效;它控制视觉折行而不改变内容,适用于日志、JSON等场景,不作用于终端、搜索框或只读视图。

Alt+Z 就是 VSCode 自动换行的开关,按一次开,再按一次关,没有例外。
为什么 Alt+Z 有时没反应?
最常见原因是当前焦点不在编辑器区域——比如光标停在搜索框、终端、侧边栏或设置页里,Alt+Z 就不会触发换行切换。VSCode 只在活动的文本编辑器(即打开 .js/.py/.md 等文件的主编辑区)中响应这个快捷键。
- 确认编辑器标签页是高亮激活状态(不是灰色或半透明)
- 别在
Terminal或Output面板里按Alt+Z - 如果用了多光标或多编辑器组,确保鼠标点入了目标编辑区
自动换行开关实际影响哪些场景?
它只控制「单行超长文本是否视觉上折到下一行」,不改变文件内容、不截断字符串、不影响语法高亮或 LSP 功能。适合看日志、JSON、Markdown 表格、长 URL 或无空格的 base64 字符串。
- 开启后:
console.log("这是一个超长字符串,中间没有任何空格,会直接在编辑器里折成多行显示")看起来更易读 - 关闭后:同一行会水平滚动,适合写代码时保持缩进对齐和行号连续性
- 对 Git diff、Search Result 等只读视图无效——它们有自己的换行逻辑
想改快捷键或查配置项?
VSCode 把这个功能叫 editor.wordWrap,默认值是 off,但快捷键 Alt+Z 实际切换的是 wordWrap: "on" / "off" / "wordWrapColumn" 三态中的前两态。
- 手动改配置:在
settings.json里加"editor.wordWrap": "on" - 重映射快捷键:打开
Keyboard Shortcuts(Ctrl+K Ctrl+S),搜editor.action.toggleWordWrap,右键修改 - 注意:Mac 用户是
Option+Z,不是Cmd+Z(那是撤销)
换行逻辑本身不耗性能,但开启后若文档含大量超长无空格行(比如 minified JS),渲染可能略卡——这不是 bug,是浏览器文本布局的自然表现。


















