alt+z（windows/linux）或 option+z（macos）是vscode中唯一触发换行开关的快捷键，不可重映射；按一次开启，再按关闭，状态栏实时显示“换行”或“不换行”。
Alt+Z（Windows/Linux）或 Option+Z（macOS）是唯一快捷键
它直接触发 editor.action.toggleWordWrap 命令，没有替代快捷键，也不能通过键盘设置重映射——VSCode 把这个绑定写死了。按一次开，再按一次关，右下角状态栏会立刻显示“换行”或“不换行”，实时反馈。
常见无效现象包括：
- 按了没反应：光标不在编辑器主区域（比如停在终端、搜索框、设置页、侧边栏）
- 开了也不折：当前文件类型（如
JSON、markdown）启用了 language-specific 设置，覆盖了全局editor.wordWrap - 只对当前标签页生效：关闭再打开，恢复为配置值，不是记忆上次开关状态
为什么改了 settings.json 还不换行
核心配置项是 editor.wordWrap，但它有多个取值，效果完全不同：
-
"on"：最常用，在视口右边界强制视觉折行，适合日志、JSON、长 URL -
"off"：默认值，不换行，必须拖水平滚动条 -
"wordWrapColumn"：需配合editor.wordWrapColumn（如120），只在指定列数换行 -
"bounded"：取视口宽度与wordWrapColumn的较小值，适合多屏适配 -
"auto"或"inherit"：几乎等于"off"，行为不可控，别用
如果配置里写了 "editor.wordWrap": "auto"，它不会换行；如果写了 "inherit"，而你没设父级配置，结果就是关着。
language-specific 设置会悄悄覆盖全局配置
VSCode 允许为每种语言单独配置换行行为。比如你全局设了 "editor.wordWrap": "on"，但打开一个 .json 文件时仍不换行，大概率是 JSON 专属设置把它关了。
验证和修复方法：
- 点击右下角语言标识（如
JSON）→ 选 “Configure 'JSON' language based settings” - 在弹出的 JSON 片段中检查是否有
"editor.wordWrap": "off" - 删掉这行，或显式改成
"on"，保存后当前文件立即生效
Python、Markdown、YAML 等也同理。不是所有语言都默认继承全局设置，尤其被插件接管的语言模式更易覆盖。
超长无空格串（base64、minified JS）还是不折？这是渲染限制
VSCode 的 word wrap 默认按空格、制表符、连字符等断点折行。遇到中间无分隔符的超长串（如 eyJhbGciOi...），"on" 和 "wordWrapColumn" 都不会切——这不是 bug，是浏览器文本布局引擎的固有限制。
可行对策：
- 用
"wordWrapColumn"配极小值（如40），逼它在固定位置硬切 - 手动插入零宽空格（
\u200b）作为软断点，适合临时调试 - 装扩展如
Trailing Spaces或自定义正则替换规则，预处理长串
别指望编辑器替你破坏原始数据结构——自动换行只是视觉层的事，内容、Git diff、执行逻辑全都不受影响。
