全局设置 editor.wordWrap 为 "on" 是最直接有效的换行方案,需手动配置;其他方式仅临时或局部生效,且特定语言设置会覆盖全局配置。

全局设置里改 editor.wordWrap 为 "on" 最直接有效
VS Code 默认不换行是设计行为,不是 bug,必须显式配置才能生效。改 editor.wordWrap 是唯一可靠的全局开关,其他方式(比如快捷键、右键菜单)只影响当前文件或临时状态。
推荐直接编辑 settings.json:按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS),输入 Open Settings (JSON) 回车,在文件中添加或修改这一行:
"editor.wordWrap": "on"
保存后立即生效,所有新打开的普通文本类文件(如 .txt、.log、.md)都会按编辑器宽度自动折行。
-
"on"是最稳妥的选择:强制换行,无视窗口缩放,行为确定 - 别用
"auto"—— 它在多数场景下几乎不触发,尤其当行末有空格或标点时判断失效 - 也别用
"inherit"—— 容易被插件、工作区或语言专属设置覆盖,导致“设了等于没设”
为什么改了 editor.wordWrap,某些文件(如 JSON)还是不换行?
因为 VS Code 对特定语言有更高优先级的 language-specific 设置,会直接覆盖全局配置。例如,.json 文件默认被设为 "editor.wordWrap": "off",哪怕你全局写了 "on",它照样不换。
排查步骤很明确:
- 打开那个不换行的文件(比如
response.json) - 看右下角语言标识(显示为
JSON),点击它 → 选Configure 'JSON' language based settings - 检查弹出的 JSON 片段里是否有
"editor.wordWrap": "off",删掉或改成"on"
或者更一劳永逸:在用户 settings.json 中统一加语言规则,例如:
"[json]": { "editor.wordWrap": "on" }
Alt+Z 快捷键为什么有时按了没反应?
这个快捷键只在 editor.wordWrap 当前值为 "auto" 或 "off" 时才有效。如果你手动设成了 "on" 或 "bounded",Alt+Z 就完全失效——它不会把你从 "on" 切回 "auto",只会卡住。
- 想让快捷键始终可用?把全局值设为
"auto",再配合Alt+Z切换 - 但要注意:
"auto"实际表现不稳定,尤其对无空格长串(如 base64、minified JS)基本不换 - 如果用了 Vim 插件等扩展,可能劫持了
Alt+Z;可打开Keyboard Shortcuts(Ctrl+K Ctrl+S),搜索editor.action.toggleWordWrap确认绑定是否被改
换行后缩进错位、第二行顶到左边怎么办?
这是软换行的常见副作用:折行后子行默认顶格,破坏嵌套结构的视觉连贯性,尤其在 JSON、YAML 或缩进敏感的 Markdown 表格里特别明显。
加一行配置就能修复:
"editor.wrappingIndent": "indent"
它会让折行后的子行继承上一行的缩进层级,对齐更自然。注意这仅影响显示,不改变实际内容,Git 提交、复制粘贴、格式化工具都完全不受影响。
真正容易被忽略的是 language-specific 设置的覆盖逻辑——哪怕你全局设了 "on",只要某个语言配置里写了 "off",它就赢了。这点不手动查一遍右下角语言设置,永远不知道为什么“明明设了却不生效”。


















