sublime text 的 subl 命令不支持 --fullscreen 参数,官方未实现;可靠方案是手动全屏后正常退出以固化 session,或使用 distraction free mode 替代。

subl 命令本身不支持 --fullscreen 参数
Sublime Text 没有原生的 --fullscreen 启动参数,任何尝试运行 subl --fullscreen 都会报错 unrecognized argument。这不是配置遗漏,而是官方根本没实现——subl 的命令行接口只接受有限几个参数,全屏不属于其中。
- 可用参数只有:
--new-window、--add、--wait、-n、-w等,文档和subl --help输出里都找不到全屏相关项 - 所谓“启动即全屏”,本质是靠窗口状态记忆(Session)或系统级快捷键触发,不是命令行控制的
- 试图用脚本模拟 F11 按键(比如 Windows 用
nircmd.exe)容易失败:窗口未就绪就发指令、多显示器下焦点错乱、升级后失效
最稳的方式:手动全屏 + 正常退出固化 Session
Sublime 在退出时会把当前窗口尺寸、位置、是否最大化/全屏等信息写入 Data/Local/Session.sublime_session,下次启动自动还原。这个机制比任何外部脚本都可靠。
- 操作只需三步:按
F11(Windows/Linux)或Ctrl+Command+F(macOS)进入全屏 → 关闭所有文件,只留一个空窗口 → 点右上角 × 或菜单File → Exit正常退出(别用任务管理器杀进程) - 重启
subl,它就会以全屏打开 - 如果启用了
"hot_exit": true(默认),偶尔会因异常退出导致 Session 损坏,建议在用户设置里显式设为false
Distraction Free Mode 是更实用的替代方案
多数人想要的其实不是操作系统级全屏,而是去掉干扰、聚焦代码的编辑体验——这时 Distraction Free Mode 比 F11 更合适,响应快、切换轻量、不占满整个屏幕。
- 启用方式:
Ctrl+Shift+P→ 输入Distraction Free Mode→ 回车 - 它隐藏菜单栏、侧边栏、标签页、状态栏(可配
"status_bar_visible": false彻底关掉) - 按
Esc瞬间退出,不用等窗口动画;切回终端、查文档、跑命令都更顺手 - 和
F11的关键区别:F11仍显示系统菜单栏(鼠标移顶呼出)、受任务栏/Dock 占位影响;Distraction Free Mode是 Sublime 自己渲染的 UI 层,完全可控
subl 命令行参数必须配对使用场景才有效
subl 的参数不是万能开关,很多功能只在特定上下文生效,乱加反而出问题。
-
--wait(或-w)只在终端等待编辑完成时有用,比如git commit调用编辑器,或写 shell 脚本做后续处理;单独运行subl -w file.txt会卡住终端,无法继续输入 -
--new-window(或-n)适合避免加载上次项目,但如果你习惯用项目工作区,频繁加这个反而打断流程 - macOS 上用
subl打开文件时,别加&后台运行(如subl file.txt &),会导致 stdin/stdout 接管失败,--wait失效、Git 提交中断 - Windows 用户注意:
subl.exe路径含空格(如C:\Program Files\Sublime Text\subl.exe)时,环境变量里必须用完整路径,不能只写C:\Program Files\Sublime Text(否则系统找不到可执行文件)










