Sublime Text状态栏内容不能靠主题文件直接“写死”，因${file_name}等字段由插件动态调用view.set_status()写入，主题仅控制左侧容器显示与布局；改content只支持有限内置变量且需重启生效，右侧区域须用StatusBarCustom等插件JSON配置驱动。
状态栏内容不能靠主题文件直接“写死”
Sublime Text 的状态栏（status bar）默认显示的 ${file_name}、${line}、${encoding} 等字段，**不是由主题文件渲染出来的静态文本**，而是由插件调用 view.set_status() 或 window.set_status() 动态写入的键值对。你改 Default.sublime-theme 里的 status_bar 块，只能控制「是否显示该区域」以及「左侧默认内容的布局容器」，但无法新增字段或替换逻辑。
常见误操作是打开 Default.sublime-theme，找到 "class": "status_bar" 后，在 content 字段里加 "${git_branch}" —— 这个变量根本不存在，Sublime 不识别，也不会报错，只是静默忽略。
-
content仅支持有限内置变量：${file_name}、${file_path}、${line}、${column}、${encoding}、${syntax}、${selection_length} - 修改
content后必须重启 Sublime 或切换一次主题才生效，热重载不触发刷新 - 即使改了
content，它也只影响状态栏最左侧那块固定区域；右侧空白区（常被 Git 插件、项目名插件占用）完全不受主题控制
用 StatusBarCustom 插件 JSON 驱动状态栏字段
这是目前最轻量、免写 Python、且真正支持变量展开和条件更新的方案。它不改主题，也不监听事件，而是通过一个配置文件声明「哪些 key 显示什么 text」，每次视图变化时自动求值。
安装后，在 Preferences → Package Settings → StatusBarCustom → Settings 打开配置，填入类似这样的结构：
[
{
"key": "project",
"text": "${project_base_name:-[No Project]}",
"priority": 100
},
{
"key": "git",
"text": "${git_branch:-} ${git_modified:-*}",
"if": "view.file_name() and view.window().folders()",
"priority": 200
}
]
-
key必须唯一，多个插件写同一个key会互相覆盖 -
text中只认预设变量，不支持 Python 表达式；${xxx:-fallback}是唯一允许的三元语法 -
if字段是字符串形式的布尔表达式，用于控制字段是否显示（例如避免在无文件的 tab 里显示空分支） -
priority决定字段在状态栏右侧的排列顺序：数值越大越靠右
自己写插件调用 set_status() 的关键细节
很多人写完 view.set_status("my_key", "hello") 发现状态栏没反应——不是代码错了，是没理解 Sublime 的状态栏分区机制。
- Sublime 默认只渲染「左侧区域」（由主题
status_bar的content控制）和「右侧临时键值区」；set_status()写入的就是后者 - 如果另一个插件（比如 GitGutter）也用了
set_status("git_branch", ...)，你的同名key就会被覆盖，且无日志提示 - output panel、find_in_files 面板、repl 控制台等非编辑视图中，
set_status()通常不生效，因为这些视图没有 status bar 上下文 - 必须监听
on_activated和on_post_save才能保证及时更新；只靠on_modified会导致光标移动时频繁刷屏
一个最小可用示例：
import sublime
import sublime_plugin
class ShowFileSizeStatus(sublime_plugin.EventListener):
def update_size(self, view):
if not view.file_name():
return
try:
size = view.size()
unit = "B" if size < 1024 else "KB"
val = size if unit == "B" else round(size / 1024, 1)
view.set_status("file_size", f"? {val}{unit}")
except:
view.set_status("file_size", "")
def on_activated(self, view):
self.update_size(view)
def on_post_save(self, view):
self.update_size(view)
为什么改了主题文件却看不到状态栏变化？
因为你可能改错了文件，或者改了但没生效路径。Sublime 的状态栏行为受两层叠加影响：主题定义的容器 + 插件注入的内容。只动其中一层，大概率白忙。
- 确认当前启用的主题：菜单
Preferences → Theme显示的是什么？别凭印象，比如你以为用的是Adaptive，实际可能是Material Theme - 主题文件必须放在
Packages/User/下，并在设置中显式指定："theme": "MyCustomTheme.sublime-theme"，否则 Sublime 不加载 -
status_bar规则在主题文件中不是独立 block，而是嵌套在"class": "overlay_control"或顶层数组里，搜索要带引号和冒号 - 某些第三方 UI 主题（如 Material Theme、Origami）会彻底重写状态栏结构，禁用原生
content渲染，此时改content完全无效
真正稳定可控的方式，始终是插件驱动：用 StatusBarCustom 管字段，用 GitGutter 管版本状态，用自定义小插件补业务逻辑——主题文件只管视觉容器和基础样式，别让它承担数据职责。
