Sublime Text需设"word_wrap": true和"wrap_width": 0实现窗口自适应软换行；语法专属配置可区分文件类型；indent_subsequent_lines:true可对齐缩进；状态栏Wrap:Off、语法设置冲突或大文件会禁用该功能。
Sublime Text 默认不自动换行，长代码行会水平溢出，靠拖动滚动条阅读效率极低——这不是 bug，是设计取舍。要让它“看长代码不用来回拉进度条”，核心就一条：word_wrap 必须设为 true（布尔值，不是字符串），且优先用 wrap_width: 0 实现窗口自适应软换行。
怎么永久开启所有文件的自动换行
菜单点一下或快捷键按一次（Alt + Z / Cmd + Option + Z）只对当前标签页生效，关掉就丢。真正一劳永逸的方法是改用户配置：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）打开设置面板 - 确保编辑的是右侧
Preferences → Settings – User（不是左侧 Default） - 在
{ }内添加两行："word_wrap": true和"wrap_width": 0 - 保存后，新打开的文件立即按窗口宽度软换行；已打开的文件可切换 Tab 刷新视图
⚠️ 常见错误："word_wrap": "true"（字符串）无效；写进左侧 Default 配置会被升级覆盖且不生效。
为什么 Markdown / 日志能换行，Python 文件却不行
代码类文件（.py、.js、.json）启用软换行后，Ctrl + → 跳词、Home/End 定位会变成“按视觉行”移动，容易误判光标位置，还可能干扰 LSP 行号解析。而 .md、.log、.txt 这类纯文本极度依赖折行阅读。
解决方案是语法专属配置：
- 先打开一个
README.md文件 - 菜单选
Preferences → Settings – Syntax Specific - 右侧会加载
Markdown.sublime-settings（首次为空），填入："word_wrap": true和"wrap_width": 0 - 保存后，所有 Markdown 文件自动启用，Python 文件完全不受影响
如果误配了 Python，直接删掉 Python.sublime-settings 即可——它不会凭空生成，也不会污染全局。
换行后第二行缩进错位，怎么对齐
默认软换行时，第二行开头是顶格的，嵌套结构（如 JSON、YAML、缩进敏感的 Python 注释）看起来像“悬空”，层级感丢失。这不是 bug，但可优化：
- 在用户设置或语法专属设置中加一行：
"indent_subsequent_lines": true - 该选项会让换行后的后续行继承首行缩进（仅对有缩进规则的语法有效，如 Python、JavaScript）
- 注意：
Plain text语法无缩进逻辑，此设置对其无效 - 它只改变渲染，复制粘贴时仍是原始单行内容
这个细节很多人忽略，但对阅读长日志、嵌套 JSON 或带缩进的文档提升明显。
改了设置还不换行？优先级和干扰项排查
最常踩的坑不是配置写错，而是被更高优先级规则压制：
- 右下角状态栏显示
Wrap: Off？点它一次，会强制写入当前视图设置（最高优先级） - 文件绑定了语法（比如
.log被识别为Plain text），但对应语法专属设置里写了"word_wrap": false，它会直接屏蔽全局配置 - 文件过大（几十 MB 的日志），Sublime 会主动禁用
word_wrap保性能，此时配置静默失效 - 插件冲突：如
Origami、TrailingSpaces某些版本会重置视图设置，临时禁用验证即可
真正容易被忽略的是：软换行只是显示层行为，不插入换行符、不改变文件内容、不影响复制粘贴、不参与 LSP 分析或代码执行。需要真实断行（比如整理超长 SQL 或日志字段），得靠正则替换或专用插件，不是开这个开关能解决的。
