按Alt+Z(Win/Linux)或Option+Z(macOS)可即时切换当前编辑器换行状态,右下角实时显示;若无效,检查语言特定设置或焦点位置;全局启用需设editor.wordWrap为"on"。

怎么立刻让当前文件换行显示
按一次 Alt + Z(Windows/Linux)或 Option + Z(macOS),当前编辑器就切换换行状态。右下角状态栏会实时显示“换行”或“不换行”,不用点菜单、不改设置,适合临时看日志、查长 JSON 或读 Markdown 表格。
常见错误现象:按了没反应——大概率是当前语言启用了 language-specific 设置,覆盖了全局配置;或者焦点不在编辑器主区域(比如在搜索框、终端、侧边栏里)。
- 确保光标在代码/文本编辑区内部
- 如果仍无效,检查右下角语言标识(如“Plain Text”“JSON”),点击它 → “Configure 'JSON' language settings” → 把
editor.wordWrap改为"on"
如何让所有文件默认自动换行
直接改用户级设置最稳妥:Ctrl + ,(Win/Linux)或 Cmd + ,(macOS)打开设置,搜 word wrap,找到 Editor: Word Wrap,选 on。
这个设置写在用户 settings.json 里,对所有工作区、所有文件类型生效,比改 workspace 或 language-specific 更可靠。
- 不要选
auto——它本质等同于off,只在极少数宽屏+窄内容场景下才触发,实际几乎不换行 - 别用
inherit,它依赖父级设置,容易被插件或工作区配置意外覆盖 - 改完不用重启,立即生效;但已打开的文件可能需要手动触发一次
Alt + Z才刷新渲染
固定列数换行(比如强制 80 列折行)怎么配
想严格按编码规范控制阅读宽度?不能只设 editor.wordWrap: "on",得配合 editor.wordWrapColumn 和换行模式。
正确组合是:"editor.wordWrap": "wordWrapColumn" + "editor.wordWrapColumn": 80。这样无论窗口多宽,第 80 列后的内容都会视觉折行。
-
bounded模式看似灵活,但实际行为难预测:它取视口宽度和wordWrapColumn的较小值,窗口缩小时可能突然切回软折行,破坏一致性 - 注意:这只是显示效果,
git diff、eslint、格式化工具完全感知不到——它们看到的仍是原始单行 - Markdown 预览、终端输出、复制粘贴时,折行不会被保留,别指望靠它生成带硬换行的文档
为什么改了设置还是不换行
最大概率是 language-specific 设置优先级更高,尤其对 .json、.md、.log 这类非代码文件,VSCode 默认关掉了它们的换行。
验证方式:打开一个不换行的文件 → 看右下角语言标签 → 点击 → “Configure 'XXX' language based settings” → 检查是否有 "editor.wordWrap": "off" 这行。
- 删掉这行,或改成
"on",保存后当前文件立刻生效 - 如果多个语言都要统一处理,直接在用户 settings.json 里加一条:
"[json]": { "editor.wordWrap": "on" } - 另一个隐蔽原因:
editor.wrappingIndent设成了"none",会导致换行后缩进丢失、文字紧贴左边界,看起来像“没换行”——建议保持默认"same"或设为"indent"
换行只是渲染层的事,文件内容毫发无损。真正容易被忽略的是:language-specific 设置像影子一样潜伏在每个文件类型背后,不主动点开确认,永远不知道它正在悄悄关掉你刚配好的 editor.wordWrap。


















