快捷键Alt+Z(Windows/Linux)或⌥+Z(macOS)可临时切换当前视图自动换行,优先级最高;菜单路径为View → Word Wrap,勾选即开、取消即关;该操作仅影响当前标签页,关闭后恢复默认设置。

怎么用快捷键或菜单临时切换自动换行
Alt+Z(Windows/Linux)或 ⌥+Z(macOS)是最快验证和干预的方式,它直接修改当前视图的 word_wrap 状态,优先级最高。菜单路径是 View → Word Wrap,勾选即开,取消即关。
常见现象:改了用户配置却没反应,大概率是这个开关被手动点成了 Wrap: Off(右下角状态栏可见)。点一下就能强制刷新,不用重启、也不用重开文件。
- 该操作只影响当前标签页,关闭再打开就恢复默认设置
- 插件(如 SideBarEnhancements、Origami)可能在后台调用
view.settings().set('word_wrap', False),导致你刚点开又自动关掉 - Git diff、控制台输出、侧边比较等内置特殊视图不支持
word_wrap,快捷键和菜单在此类视图中会灰显或静默失败
如何永久开启所有文件的自动换行(用户级配置)
打开 Preferences → Settings – User(不是左侧的 Default),在右侧 JSON 中添加两行:
{
"word_wrap": true,
"wrap_width": 0
}
word_wrap 必须是布尔值 true,写成 "true"、"auto" 或 1 都会静默失效;wrap_width: 0 表示按窗口宽度自适应软换行,设成 80 是硬截断,对中文、URL、下划线命名变量基本无效。
- 保存后,所有新打开的文件立即生效
- 已打开的文件可能需切换 Tab 或点击右下角
Wrap: Off强制重绘 - 别碰
Settings – Default,升级会被覆盖,且不生效
为什么 Markdown 能换行,Python 却不行
Sublime 的设置加载优先级是:视图设置 > 语法专属设置 > 用户设置 > 默认设置。很多代码类语法(如 Python.sublime-settings)自带 "word_wrap": false,会直接盖掉你全局设的 true。
解决方法:打开一个 .md 文件 → Preferences → Settings – Syntax Specific → 在右侧加 "word_wrap": true,保存后所有 Markdown 文件生效。同理,日志文件可配 Plain Text.sublime-settings 或 Log File.sublime-settings。
- 如果误给 Python 配了这个,直接删掉
Python.sublime-settings文件即可——它不会凭空再生 - 语法专属配置实际存为独立文件(如
Markdown.sublime-settings),不污染全局 - 别把语法专属配置误写进主
Preferences.sublime-settings,否则无效
代码文件要不要开 word_wrap
不建议对 .py、.js、.json 等代码类文件启用 word_wrap。这不是显示问题,而是功能干扰:
-
Ctrl+→/Home/End键按“视觉行”跳转,不是物理行,容易误判光标位置 - LSP 插件(如 pylsp)依赖原始行号,折行后跳转、悬停提示可能偏移
- 缩进识别异常,比如多层嵌套字典被折成三行,Tab 缩进可能只作用于第一段
- 复制整行时仍复制原始单行内容,但你眼睛看到的是三段,易误以为结构已变
真正需要换行的是 .md、.log、.txt 这类纯文本文件。状态栏的 Wrap 开关、项目级 .sublime-project 配置、语法专属设置这三层覆盖关系,最容易被忽略。改完一定要保存,JSON 格式错误(比如少逗号)会导致整个配置失效。


















