Sublime Text 默认不开启自动换行，需手动启用 word_wrap；设为 true 后按窗口宽度软换行，建议 wrap_width 设为 0，并配合 indent_subsequent_lines:true 实现缩进对齐，但该功能仅渲染生效、不修改文件内容。
Sublime Text 默认不开启自动换行，必须手动启用，且「软换行」和「硬换行」行为完全不同——误设为 wrap_width 或开启 word_wrap 但未配 auto_indent，会导致编辑体验断裂。
怎么打开 Word Wrap（基础开关）
自动换行不是默认开启的，必须显式设置。最直接的方式是快捷键触发，或修改配置项：
- Windows/Linux：按
Alt+Z；macOS：按⌥+Z—— 这是切换word_wrap布尔值的快捷方式，实时生效 - 若需永久生效，在
Preferences → Settings的用户配置（右侧）中添加："word_wrap": true
- 注意：仅设
"word_wrap": true不代表所有文件都生效——它受语法高亮类型、文件大小、视图模式（如侧边比较 diff）影响，比如在Git Blame面板里该设置无效
为什么开了 word_wrap 还不换行？检查 wrap_width 和 auto_wrap
word_wrap 开启后，Sublime Text 默认使用「无限宽度软换行」（即按窗口宽度折行），但如果你设置了 wrap_width，它会强制按字符数截断，反而可能让长行不换行（尤其当值设得过大或为 0）：
-
"wrap_width": 0表示禁用基于字符数的换行（推荐设为 0，避免干扰） -
"wrap_width": 80会让每行最多显示 80 字符，超出部分换行 —— 但这是「硬约束」，对 Markdown 预览、日志文件等反而更难读 - 真正影响视觉换行的是
word_wrap+ 窗口宽度，wrap_width是可选覆盖项，日常使用建议保持"wrap_width": 0 - 如果某类文件（如
.log）始终不换行，检查是否被view.settings().set('word_wrap', False)脚本强制关闭了（常见于插件如SideBarEnhancements）
如何让换行后缩进对齐（避免首行突兀）
默认软换行时，第二行开头不会缩进，阅读长 JSON 或嵌套代码时容易丢失层级感。这不是 bug，是设计行为，但可通过配置改善：
- 在用户设置中加入：
"indent_subsequent_lines": true
，它会让换行后的后续行继承首行缩进（对 Python/JS/YAML 类缩进敏感语言有效） - 该选项不影响实际文本内容，只改变渲染 —— 所以复制粘贴时仍为单行原始字符串
- 注意：它对
Plain Text语法无效（无缩进规则），需切换到对应语法（如JavaScript）才生效 - 如果用了
TrailingSpaces插件，开启word_wrap后可能高亮错误位置偏移，建议关掉该插件的highlight_on_wrap选项（如有）
不同文件类型下自动换行的兼容性问题
Sublime Text 对某些格式做了特殊处理，word_wrap 在它们身上表现不一致：
-
.md（Markdown）：默认开启换行，但预览窗口（Markdown Preview插件）完全独立于编辑器设置，需另配插件参数 -
.log/.txt：常被识别为Plain Text，此时indent_subsequent_lines失效，建议右下角点击语法名，手动切到Text或Log File（如有） -
Minified JS/CSS：单行超长，但语法解析器可能因性能原因跳过换行计算 —— 可临时用Ctrl+Shift+P → "Reindent Lines"强制触发重绘 - 大文件（>10MB）：Sublime Text 会自动禁用
word_wrap以保响应速度，无法绕过，这是硬限制
最易被忽略的一点：Sublime Text 的换行是纯渲染层行为，不修改任何文件内容。如果你以为开启了 word_wrap 就等于「保存时自动插入换行符」，那就踩进最大坑了——它和 soft_wrap、auto_insert_newlines 完全无关，后者根本不存在于原生功能中。
