软换行仅视觉折行,不插入换行符;启用方式有菜单、快捷键(Alt+Z/Cmd+Option+Z)或右键勾选;默认需在用户设置中配置"word_wrap": true且JSON格式正确。

软换行只是视觉折行,不插入 \n
Sublime Text 的软换行(Word Wrap)默认就是纯显示行为——它只改变文本在编辑器里的渲染方式,不会往文件里写任何换行符或空格。你看到的“折行”是编辑器动态计算的,保存后文件内容完全不变。
如何开启软换行显示?
有三种等效方式,任选其一即可:
- 菜单栏点击 View → Word Wrap(带勾表示已启用)
- 快捷键:
Alt+Z(Windows/Linux)或Cmd+Option+Z(macOS) - 右键编辑区空白处,勾选 Word Wrap
启用后,长行会在视口宽度处自动视觉折行,但光标移动、搜索、正则匹配、Git diff 等所有底层操作仍按原始单行处理。
word_wrap 配置项和常见误配
如果想让软换行默认开启,需修改用户设置。打开 Preferences → Settings,在右侧用户配置中添加:
{
"word_wrap": true,
"wrap_width": 0
}
"wrap_width": 0 表示按视口宽度自动折行;设为具体数字(如 80)则按列数强制折行(仍不改内容)。注意别写成 "word_wrap": "true"(字符串)或漏掉逗号导致 JSON 解析失败——这会导致设置不生效,看起来像“开了没反应”。
为什么有时软换行像“失效”了?
常见原因只有两个:
- 当前语法高亮模式禁用了软换行(极少见),可临时切换到 Plain Text 测试
- 文件被标记为“不可换行”类型,比如某些日志或二进制文件,Sublime 会主动禁用软换行以避免误读;此时检查右下角状态栏的语法名,或手动执行 View → Word Wrap 强制启用
真正影响内容的不是软换行,而是手动按 Enter 或使用 wrap_lines 命令——后者才会插入真实换行符。










