Sublime Text 的 word_wrap 是纯视觉软换行，不修改文件内容；需设为布尔值 true/false，字符串无效；语法专属设置和视图级开关（Alt+Z/Cmd+Option+Z）优先级更高；配合 wrap_width: 0 和 indent_subsequent_lines: true 可优化显示。
Sublime 的 word_wrap 不是“段落换行”，而是“软换行”显示功能
Sublime Text 没有真正的“wrap paragraph”（段落重排）功能，比如像 Word 那样把一段文字按语义重新折行、插入 \n。它只有 word_wrap——纯视觉层的软换行，不修改文件内容，也不影响复制、保存或运行逻辑。
你看到的“换行”，只是编辑器在渲染时把超长行截断显示，实际源码里仍是单行。所以别指望它帮你格式化 Markdown 段落或整理日志字段，那得靠正则替换或插件。
-
word_wrap必须设为布尔值true或false，写成"true"（字符串）会静默失效 - 默认行为是
"auto"，但 Sublime 实际只识别布尔值；设成字符串不会报错，但也不生效 - 开启后，
Ctrl+←/→和Home/End会按“视觉行”跳转，不是整行首尾——这点容易误操作
全局启用自动换行但没效果？优先检查语法专属设置是否覆盖
改了用户设置里的 "word_wrap": true 却没反应，大概率是当前文件绑定了某种语法（比如 Plain text、Markdown 或 JSON），而该语法对应的 .sublime-settings 文件里写了 "word_wrap": false，直接覆盖了全局配置。
- 打开一个目标文件（如
readme.md），确认右下角显示的语法名称（例如 “Markdown”） - 执行
Preferences → Settings – Syntax Specific，会打开类似Markdown.sublime-settings的文件 - 在里面添加：
{"word_wrap": true, "wrap_width": 0} - 保存即生效，无需重启；首次保存会自动创建该文件
为什么日志、纯文本文件死活不换行？状态栏和快捷键可能被手动关了
即使配置全对，某些文件仍不换行，常见原因是视图级开关被手动关闭了——这个开关优先级最高，能压倒所有配置文件。
- 看右下角状态栏：如果显示
Wrap: Off，直接点击它就能切换 - 快捷键：Windows/Linux 是
Alt+Z，macOS 是Cmd+Option+Z，按一次就开/关 - 如果启用了
Vintage模式（Vim 模拟），Esc后再按z w也会触发，容易误触 - 大文件（几十 MB 日志）可能被 Sublime 主动禁用
word_wrap保性能，此时配置无效，属正常限制
想让换行更顺眼？wrap_width 和 indent_subsequent_lines 得配着用
默认软换行是硬切，常把 JSON 字段或长 URL 断在中间，阅读吃力。虽然不能智能按标点折行，但有两个参数能明显改善观感：
-
"wrap_width": 0：推荐设为0，表示完全自适应窗口宽度；设成80反而在宽屏上制造多余折行 -
"indent_subsequent_lines": true：第二行起自动缩进到上一行文字起始位置，避免“悬空”感（注意：该参数需放在语法专属设置中才稳定，全局设有时被忽略） - 别混用旧参数：
word_wrap_column已废弃，和wrap_width同时存在时后者优先生效
真正麻烦的是：不同文件类型需求冲突——代码文件不该折，文档类必须折。没有银弹，只能分语法配，而且得记住每次新建一种类型文件，都得补一次 Settings – Syntax Specific。
