必须先打开对应语法文件（如.md）再进settings–syntax specific，才能生成正确的语法专属json配置文件（如markdown.sublime-settings），否则右侧面板为空或错误；"word_wrap": true需为布尔值，建议同时设"wrap_width": 0；python默认false是设计使然，删其配置文件即可恢复全局控制；验证生效需确认右下角语法名匹配，并检查wrap: off、vintage模式及文件大小。
怎么在 Preferences → Settings – Syntax Specific 里开自动换行
必须先打开对应语法的文件（比如一个 .md 或 .log），再进语法专属设置，否则右侧面板加载的是空配置或错误语法名。这个操作会生成一个以语法命名的独立 JSON 文件（如 Markdown.sublime-settings），只影响该语法类型的所有文件。
常见错误现象：直接在主 Preferences → Settings – User 里写 "word_wrap": true，结果对 Markdown 还是没用——因为语法专属设置优先级更高，但你根本没建它。
-
"word_wrap"必须是布尔值true，写成"true"、"auto"或1都会被静默忽略 - 建议同时加
"wrap_width": 0，避免依赖 Sublime 模糊的内置默认值（约 120 列） - 保存后，所有已打开和新打开的同语法文件立即生效；不用重启，也不用重开文件
为什么 Python.sublime-settings 里常有 "word_wrap": false
Sublime 的 Python 语法包自带 Python.sublime-settings，默认关掉软换行。这不是 bug，是设计选择：代码类文件开启 word_wrap 会影响光标跳转（Ctrl+→ 按视觉行而非物理行）、LSP 行号解析、缩进识别等底层行为。
如果你误开了 Python 的自动换行，又找不到那个文件：直接删掉 Python.sublime-settings 即可——它不会自动再生，删完就恢复全局配置的控制权。
- 路径通常在：
~/.config/sublime-text-4/Packages/User/Python.sublime-settings（Linux）或~/Library/Application Support/Sublime Text/Packages/User/Python.sublime-settings（macOS） - 别试图在语法设置里写
"word_wrap": true然后期望它“智能适配代码”，它只会让编辑体验变糟 - 日志或纯文本类文件（
Plain Text、Log File）才适合开，且要确认右下角状态栏显示的语法名完全匹配
怎么验证当前文件是否真用了语法专属设置
右下角状态栏会显示当前语法名（如 Markdown、Plain text、Python），点它能快速切换语法——这是排查“为什么没生效”的第一动作。如果显示的是 Plain text，但你想配日志，就得去 Plain Text.sublime-settings，而不是 Log File.sublime-settings（后者只在插件提供该语法时存在）。
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）输入Settings: Syntax Specific，可直接打开当前语法的专属设置 - 如果打开后右侧是空的，说明还没创建过该文件；加完配置保存，它就自动生成
- 如果右侧已有内容，检查是否含
"word_wrap": false——有就删掉，或者改成true
改完还是不换行？优先检查这三处
语法专属配置写对了，但依然不换行，大概率不是配置问题，而是被更高优先级的临时设置压制。
- 右下角状态栏是否显示
Wrap: Off？点它一次，相当于执行view.settings().set('word_wrap', true)，优先级最高 - 当前文件是否处于 Vintage 模式（Vim 模拟）？按
Esc后再按z w也会切开关，容易误触 - 文件是否过大（比如几十 MB 的日志）？Sublime 会在后台自动禁用
word_wrap保性能，此时任何配置都无效
真正容易被忽略的是：语法专属设置一旦存在，就会彻底屏蔽用户级配置，哪怕你只改了一行，也得去对应语法文件里动——没有“继承+覆盖”机制，只有“覆盖”。
