Sublime Text 无内置“换行自动排版”功能，word_wrap仅实现软换行（显示层折行，不修改代码），真正自动重排需依赖插件（如sublime_black、JsPrettier）并配置black/prettier等外部命令环境。
Sublime Text 没有内置的“换行自动排版”功能——它只有软换行（word_wrap），不修改内容、不重写代码结构；所谓“自动排版”，必须靠插件（如 sublime_black、JsPrettier）实现，且需额外配置运行环境。
为什么改了 word_wrap 还是不能“自动排版”
很多人混淆了两个概念：word_wrap 是纯显示控制（软换行），而“自动排版”指重写源码（如把长 if 拆成多行、统一缩进、调整括号位置）。Sublime 默认只做前者，后者根本不存在于原生功能中。
-
word_wrap设为true后，只是让超长行在界面上折行显示，复制粘贴仍是单行原始字符串 - JSON / Python / JS 文件里出现“换行错位”“缩进断裂”，不是排版问题，而是
word_wrap渲染时未启用indent_subsequent_lines - 试图用
"word_wrap": "auto"或"auto_wrap": true实现格式化？这些值要么无效，要么已被弃用
想真正自动重排代码？必须装插件 + 配环境
原生 Sublime 不提供任何代码重排能力。要实现保存即格式化、选中即美化，得依赖外部工具链：
- Python：装
sublime_black插件，并确保系统已安装black命令（pip install black） - JavaScript/TypeScript/JSON：用
JsPrettier，需提前装好prettier（npm install -g prettier） - SQL：选
SQLBeautifier，依赖sqlparse或本地pg_format - 关键检查点：
which black或prettier --version必须在终端返回有效结果，否则插件静默失败
word_wrap 配合哪些设置才能“看着像排版”
如果你只是想让软换行更可读（尤其对嵌套结构），靠的是渲染微调，不是重排：
- 在
Preferences → Settings – User中加："indent_subsequent_lines": true—— 它会让第二行起继承首行缩进（仅对 Python/JS/YAML 等有语法缩进规则的语言生效） - 务必同时设
"wrap_width": 0；若混用"wrap_width": 80，会触发硬截断逻辑，反而破坏indent_subsequent_lines的对齐效果 -
"indent_subsequent_lines"对Plain text语法无效——它不识别缩进层级，所以日志或纯文本文件里顶格换行是正常行为 - 别指望它修复 JSON 中的长数组换行：JSON 语法本身禁用
word_wrap（默认"word_wrap": false），因为换行可能干扰校验逻辑
常见失效场景和绕过方式
即使配置全对，也可能被更高优先级规则压制：
- 右下角状态栏显示
Wrap: Off？点它强制切换——这个视图级开关优先级高于所有配置文件 - 打开一个 .py 文件后发现不换行？大概率
Python.sublime-settings里写了"word_wrap": false，删掉这行或改成true - 用了 Vintage 模式（Vim 模拟）？按
Esc后再按z w也会切word_wrap，容易误触导致“配了却关着” - 大文件（>10MB）中
word_wrap可能被 Sublime 自动禁用保性能，此时改配置无反应，属设计行为，非 bug
真正难的从来不是加几行配置，而是分清哪些事 Sublime 能做（软换行渲染）、哪些必须交出去（用 black/prettier 重排）；一旦混淆，所有调试都在错误方向上打转。
