trim_trailing_white_space_on_save不生效是因高优先级规则覆盖，需检查语法专属设置、project文件、TrailingSpaces插件冲突及插件硬编码禁用；手动清理用内置Trim Trailing White Space命令最安全。
trim_trailing_white_space_on_save 配置不生效的排查路径
设了 trim_trailing_white_space_on_save 却没反应，不是配置写错了，而是被更高优先级规则压住了。常见失效点有四个：
- 右下角显示的语法类型（如
source.python、text.markdown）加载了专属设置，覆盖了全局配置；可临时切换为Plain Text测试是否恢复 -
.sublime-project文件里显式写了"trim_trailing_white_space_on_save": false，它会直接生效，无视用户设置 - 装了
TrailingSpaces插件且启用了trailing_spaces_on_save，两者同时开会导致光标跳动、保存时闪一下——建议只留一个 - 某些插件（如
LaTeXTools、MarkdownPreview）在语法定义中硬编码禁用该行为，得去对应插件的Package Settings里手动补上"trim_trailing_white_space_on_save": true
手动清理当前文件的可靠方式
别用正则瞎替换，尤其新手常写的 ^\s+$ 会漏掉“只有空格没换行”的边缘情况，也匹配不到纯空行本身。真正安全的做法是用 Sublime 内置命令：
- 快捷键
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入
Trim Trailing White Space并回车 - 它只删每行末尾的空格和
\t，不动缩进、不碰空行、不伤text.markdown的硬换行（两个空格 + 换行）
如果这个命令没效果，说明当前语法类型被全局排除（比如 text.markdown），可临时切到 Plain Text 再试。
缓存卡顿问题必须连清三处，只删 Cache 不够
Sublime 卡顿、CPU 持续 100%、Goto Definition 失效，根源不是代码量大，而是缓存和索引残留。只清 Cache 目录几乎没用，必须同步处理：
-
Cache：存插件运行时产物（如pyright、texlab的 socket 和编译缓存） -
Local\Index：全文搜索和符号跳转的底层数据库，损坏后Ctrl+P/Ctrl+R变假响应 -
Packages/User/：存插件配置（如Black.sublime-settings）、命令绑定，卸载插件后残留会导致右键菜单还在但点开报错
操作前务必彻底退出 Sublime：Windows 用任务管理器确认所有 sublime_text.exe 进程消失；macOS 用活动监视器强制退出；Linux 执行 pkill -f "sublime_text"。否则删一半会被锁死或立刻写回旧缓存。
要不要加 trim_automatic_white_space？看语言和场景
trim_automatic_white_space 是个双刃剑：它会在你按 →、Enter 或点击其他行时，立刻清理当前行尾空白。适合 Python/Go 等缩进敏感语言边写边修，但要注意：
- 在
text.markdown中，两个空格 + 换行是硬换行语法，删了就坏排版 - 在
source.makefile中，行尾空格可能参与变量展开，删掉会破坏构建逻辑 - 大文件编辑时频繁触发会影响响应速度，尤其配合 LSP 插件时容易卡顿
- 它不处理空行、不碰行中空格、不删缩进空格（比如函数体内的
return x前空格）
真要用，建议搭配 trim_trailing_white_space_on_save_exclude 排除高风险语法类型，而不是全局开启。
