状态栏不显示需检查 status_bar_visible 是否为 false,删除或改为 true;若仍无效,可能是主题将 status_bar_height 设为 0 或 status_bar_template 字段错误导致失效。

状态栏显示不生效?检查 status_bar_visible 是否被设为 false
Sublime Text 默认开启状态栏,但如果你用过某些插件(比如 Origami 或自定义配置),可能被静默关闭。直接搜不到状态栏,不是界面坏了,而是它被“关灯”了。
打开 Preferences → Settings – User,确认没有这行:
{"status_bar_visible": false}
如果有,删掉或改成 true。别信“重启后自动恢复”——这个设置是硬开关,不改就不会亮。
- Windows/macOS/Linux 全平台统一行为,无兼容差异
- 如果改完仍不显示,可能是主题覆盖了状态栏高度(比如某些极简 UI 主题把
status_bar_height设为 0) - 命令面板里运行
view.show_panel("status_bar")是无效的——这不是面板,不能用 show_panel 控制
想加 Git 分支、编码格式、行尾符?靠 status_bar_extras 插件不靠谱
网上一堆教程推 status_bar_extras 或类似插件,实际装了发现:分支名不更新、切换文件就丢信息、甚至拖慢保存响应。根本原因是 Sublime 的原生 API 不支持实时重绘状态栏字段,插件只能靠轮询或监听 view 变化,既不准又吃资源。
真要稳定显示,得用 Sublime 自带的 statusbar 配置机制 + 少量 Python 插件逻辑:
- Git 分支:依赖
git命令行可用,且项目根目录含.git;否则显示 “No Git” - 编码/行尾符:Sublime 会自动写入
encoding和line_ending到状态栏右端,无需插件——前提是没被status_bar_template覆盖 - 自定义字段必须用
EventListener.on_modified_async()或on_activated_async()触发更新,不能靠定时器
status_bar_template 怎么写才不崩?字段顺序和空格是关键
这个配置项允许你用模板字符串控制状态栏内容排列,但它非常脆弱:少一个空格、多一个未定义字段、字段名拼错,整行就变空白或回退到默认样式。
正确写法示例(放在 Settings – User 中):
"status_bar_template": "{file_name} — {file_encoding} | {file_line_endings} | {file_size_bytes}B | {git_branch}"
注意这些细节:
- 只支持官方文档列出的字段:
{file_name}、{file_path}、{file_encoding}、{file_line_endings}、{file_size_bytes}、{git_branch}(需启用 Git 插件) -
{git_branch}在非 Git 项目中会留空,不会报错;但{undefined_field}会导致整个模板失效 - 字段之间必须用空格或符号分隔,不能连写,比如
{file_name}{file_encoding}会不渲染 - 模板长度超过状态栏宽度时,右侧字段会被截断,不会换行
Python 插件扩展状态栏?绕不开 EventListener 和 set_status()
想显示 LSP 诊断数、当前函数名、或自定义标记,必须写插件。核心就两步:监听事件 + 调用 view.set_status()。
常见错误是直接在 on_load() 里塞逻辑——文件加载时语法高亮还没就绪,view.scope_name(0) 可能返回空。应该用 on_activated_async() 或 on_modified_async():
def on_activated_async(self, view):
if view.file_name():
branch = self.get_git_branch(view)
view.set_status("git_branch", f"⎇ {branch}")
几个硬约束:
-
set_status()的 key(如"git_branch")不能含空格或特殊字符,否则不显示 - 同一个 key 多次调用会覆盖,不是追加;想组合多个信息,得自己拼字符串再 set
- 状态栏宽度有限,建议限制字符数,比如
branch[:16] + "…" if len(branch) > 16 else branch - 插件里的路径判断要用
view.window().folders()找工作区,别硬写/Users/xxx/project
最麻烦的其实是状态同步:关闭标签页、切换分组、后台切回时,状态栏容易残留旧值。没做 on_close() 清理的话,那个小字就一直挂着。

















