是，状态栏插件必须依赖package control才能稳定安装和更新；手动安装虽可行但易因st4 api变更失效，且无法自动更新。
状态栏插件必须依赖 Package Control 才能装吗
不是必须，但强烈建议用。Sublime Text 原生不提供状态栏内容定制能力，所有功能增强都依赖插件，而 Package Control 是最稳定、更新及时、兼容性最好的插件分发渠道。手动安装虽可行（比如从 GitHub 下载 StatusBarEnhanced ZIP 解压到 Packages 目录），但容易因 Sublime Text 4 的 API 变更导致插件失效，且后续无法自动更新。
常见错误现象：StatusBarEnhanced 安装后状态栏无变化、命令面板搜不到 status_bar_enhanced 相关命令、或打开设置时报 Unable to open ... settings 错误。
- 确保已安装
Package Control：按Ctrl+Shift+P输入Package Control: Install Package，能正常弹出列表即为成功 - 不要直接复制旧版教程里的控制台代码（如含
urllib2或 SHA1 校验的），Sublime Text 4 已弃用部分模块，应使用官网最新安装脚本 - Windows 用户注意路径权限：若
Packages目录在AppData\Roaming下，避免以管理员身份运行 Sublime 后再普通用户下安装插件，会导致权限冲突
安装 StatusBarEnhanced 后为什么状态栏还是空的
装完只是第一步，StatusBarEnhanced 默认不启用任何字段，需要手动配置。它不会像某些 IDE 插件那样“开箱即用”，而是把控制权交给你——你得告诉它显示什么、在哪显示、怎么格式化。
典型使用场景：显示当前文件编码、行尾符（CRLF/LF）、光标行列号、语法类型、Git 分支、甚至自定义 shell 命令输出（如 git status --porcelain）。
- 打开
Preferences → Package Settings → StatusBarEnhanced → Settings，编辑右侧用户配置文件 - 至少要写一个
"items"数组，例如：[{"type": "encoding", "format": "ENC: {value}"}] - 每个 item 必须含
"type"（合法值见插件文档，如"encoding"、"line_endings"、"git_branch"），否则该条目被忽略 - 如果用了
"git_branch"却没显示，检查当前文件是否在 Git 仓库内（非根目录下子文件可能检测失败）
如何让状态栏显示 Git 当前分支和修改状态
StatusBarEnhanced 支持 Git 集成，但默认只显示分支名，不显示「已修改」这类状态。要补全，得组合多个 item 并配合正则提取，或者改用更轻量的替代方案。
性能影响明显：每秒轮询 git status 会拖慢大仓库响应；兼容性上，Windows 用户需确保 git 在 PATH 中，否则报错 git not found。
- 推荐配置（简洁可靠）：
[{"type": "git_branch", "format": "⎇ {value}"},{"type": "git_status", "format": "{staged} {unstaged} {untracked}", "on_change": true}] -
"on_change": true表示仅在文件保存或 Git 状态变更时刷新，避免持续轮询 - 若想显示「●」表示有未提交更改，可用
"format": "{staged:+●}{unstaged:+●}{untracked:+●}"，但注意空格处理逻辑 - 不建议用
shell类型调外部命令——调试困难、超时难控、跨平台路径易出错
状态栏文字太挤或位置错乱怎么办
状态栏宽度固定，插件默认左对齐、无间隔。多个 item 挨在一起时，中文字符宽度不一、图标渲染异常、或长分支名截断，都会导致视觉混乱。
容易踩的坑：盲目加空格或制表符到 format 字段，结果在不同字体/缩放比例下表现不一致；或误用 "align" 参数（该参数只对整个状态栏生效，不作用于单个 item）。
- 用
"padding"控制 item 内边距，例如"padding": " "（两个空格）比硬塞空格更可控 - 优先用 Unicode 符号替代文字：用
⎇代替branch:，用✎代替modified，节省空间且风格统一 - 长文本截断靠
"max_width"，设为12可防分支名过长（如feature/user-auth-refactor-v2→feat/user-...） - 重启 Sublime Text 后才生效某些布局调整，单纯重载插件不够
真正麻烦的不是装插件，而是搞清每个 type 背后的数据源和刷新时机。比如 "file_size" 显示的是磁盘大小而非编辑器缓存大小，"syntax" 名称取决于 .sublime-syntax 文件头定义，不是文件后缀。这些细节不查文档就容易白调半天。
