Sublime Text 唯一可靠沉浸式写作方案是原生 distraction_free_mode,需在用户设置中严格配置 "distraction_free": { "draw_centered": true, "margin": 60, "padding_top": 80, "padding_bottom": 80 },并通过 Ctrl+Shift+P 输入 Enter Distraction Free Mode 触发,退出用 Esc 最稳。

FocusMode、DistractionFreeMode 的第三方插件在 Sublime Text 4/5 上已失效或引发崩溃,强行安装反而会导致 view.is_primary() 异常、保存失败或命令面板失灵。
真正能用的只有原生 distraction_free_mode,它不靠插件,只靠正确配置 + 正确触发。
为什么 FocusMode 类插件根本不能用
这类插件大多基于 ST2/ST3 旧 API 编写,无法适配 ST4+ 的视图生命周期和配置加载机制:
- 它们试图用
view.window().run_command("show_panel", ...)控制 UI,但 ST4 默认禁用非主视图的 panel 操作,直接报错 - 硬编码修改
distraction_free_mode行为,而 ST4 要求所有 DF 配置必须包裹在"distraction_free": { }内,插件却往顶层写设置,完全被忽略 - 部分插件会覆盖
toggle_distraction_free命令绑定,导致你按Shift+F11后 UI 卡死、Esc失效
怎么正确启用 distraction_free_mode(不是 F11)
F11 只是系统窗口拉伸,菜单栏、侧边栏、标签栏全在;真正起效的是 Sublime 自身的 distraction_free_mode:
- Windows/Linux:
Shift+F11(不是F11,也不是已弃用的Ctrl+Shift+F) - macOS:
Cmd+Shift+F11(部分外接键盘需加Fn键) - 快捷键失效?先关中文输入法(搜狗/微软拼音),再打开
Preferences → Key Bindings搜索shift+f11看是否被插件覆盖 - 兜底方案:
Ctrl+Shift+P/Cmd+Shift+P→ 输入Enter Distraction Free Mode回车 - 退出最稳方式:
Esc(比再按一次快捷键更可靠,尤其插件多时)
为什么改了设置没反应?三个覆盖点必须检查
你在 Preferences → Settings – User 里写了 "draw_centered": true 却没变化,问题几乎都出在这三处:
- 配置写错位置:必须加在右侧的 User Settings JSON 里,不是
Default,也不是已废弃的Distraction Free – User.sublime-settings - 主题强绑定:Material Theme、Ayu、Soda 等自带
distraction_free.sublime-settings,优先级高于你的设置;先切回默认主题验证是否生效 - 插件劫持视图:Origami、SideBarEnhancements 会重写窗口布局逻辑,导致
sidebar_visible等设置被忽略;临时禁用插件测试最准
让文字真正“悬浮居中”的三个必配参数
默认 distraction_free_mode 只清 UI,不调排版。要达到写作级舒适感,必须在 User Settings 里显式添加这三项,且严格包裹在 "distraction_free": { } 对象内:
-
"draw_centered": true—— 不加这句,文本永远左对齐,DF 感归零 -
"margin": 60—— 控制左右留白,40–80 是阅读舒适区间;设成 0 贴边,120 行宽太窄 -
"padding_top": 80和"padding_bottom": 80—— 必须成对添加,否则上下紧贴屏幕边缘;默认不生效,不加就头重脚轻
别碰 wrap_width 来调宽度,它只影响自动换行位置,跟居中范围无关。

















