永久开启自动换行需在Preferences → Settings – User中添加"word_wrap": true和"wrap_width": 0;语法专属设置(如Python)会覆盖全局配置,Markdown等文本文件需单独配置Syntax Specific设置。

怎么永久开启自动换行(用户级配置)
必须改 Preferences → Settings – User,不是左侧的 Default。右侧 JSON 里加这两行:"word_wrap": true 和 "wrap_width": 0。
注意:word_wrap 必须是布尔值 true,写成 "true" 或 "auto" 都会静默失效;wrap_width 设为 0 表示按窗口宽度自适应软换行,设成 80 是硬截断,对中文、URL、下划线变量名基本无效。
保存后新打开的文件立即生效;已打开的文件可能需切换 Tab 或点击右下角状态栏 Wrap: Off 强制刷新。
为什么 Markdown 能换行,Python 却不行
Sublime 加载设置优先级是:视图设置 > 语法专属设置 > 用户设置 > 默认设置。很多代码类语法(如 Python.sublime-settings)自带 "word_wrap": false,会直接覆盖你全局设的 true。
解决方法:
• 打开一个 .md 文件 → Preferences → Settings – Syntax Specific → 右侧加 "word_wrap": true 和 "wrap_width": 0
• 同理,日志文件可配 Plain Text.sublime-settings 或 Log File.sublime-settings
• 如果误配了 Python,直接删掉 Python.sublime-settings 即可——它不会凭空再生,也不影响全局。
快捷键和状态栏开关为什么“不生效”
Alt+Z(Windows/Linux)或 ⌥+Z(macOS)是视图级开关,优先级最高,会锁死当前文件的 word_wrap 状态。
常见现象:
• 改完用户配置,但某个文件仍不换行 → 很可能你点过右下角 Wrap: Off,它已写入该视图设置
• 插件(如 SideBarEnhancements)可能在后台调用 view.settings().set('word_wrap', False),导致手动开启后瞬间关掉
• Git diff、控制台输出、侧边比较等特殊视图不支持 word_wrap,这是 Sublime 内置限制,改配置也无效
代码文件要不要开 word_wrap
不建议对 .py、.js、.json 等代码类文件启用 word_wrap,这不是显示问题,而是功能干扰:
• Ctrl+→/Home/End 键按“视觉行”跳转,不是物理行,容易误判光标位置
• LSP 插件(如 pylsp)依赖原始行号,折行后跳转、悬停提示可能偏移
• 缩进识别异常,比如多层嵌套字典被折成三行,Tab 缩进可能只作用于第一段
• 复制整行时仍复制原始单行内容,但你眼睛看到的是三段,易误以为结构已变
真正需要换行的是 .md、.log、.txt 这类纯文本文件。

















