package control必须手动安装，是sublime text硬性依赖而非推荐插件；未正确安装则无法使用package control: install package等命令，后续所有插件均无法安装。
Package Control 必须手动装，不能跳过
没它，后续所有插件都装不了——不是“推荐”，是硬性依赖。新版 Sublime Text 4 启动后直接按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Install Package Control 回车即可。旧版若弹不出该命令，说明控制台没启用或版本太老，得走 Python 控制台路径：Ctrl+` 粘贴官网最新单行脚本（注意别复制到不可见 Unicode 字符），回车执行。
验证是否成功：再按一次 Ctrl+Shift+P，输入 Package Control，能看到一长串以 Package Control: 开头的命令就对了。如果报 ImportError: No module named 'package_control'，大概率是网络代理干扰了 urllib.request，或复制时混入了零宽空格。
只装这 4 个核心插件，别碰“汉化整合包”
所谓“汉化激活整合包”本质是篡改 Preferences.sublime-settings、打 patch 破坏 plugin_host 进程，轻则插件全挂，重则高分屏渲染错位、SideBarEnhancements 右键菜单消失。真正零冲突、高频刚需的只有：
-
SideBarEnhancements：补全右键菜单（新建/重命名/删除/刷新），不改底层逻辑 -
GitGutter：行首显示 Git 修改状态（+/-/→），依赖本地git命令，不轮询 -
Emmet：HTML/CSS 快速展开，tab触发，不劫持其他快捷键 -
AutoFileName：路径补全（require('./后自动列当前目录文件），支持相对/绝对路径
安装方式统一：按 Ctrl+Shift+P → Package Control: Install Package → 输入插件名回车。别搜“汉化”“免激活”“绿色版”，那些包基本都带恶意修改。
StatusBarEnhanced 装完不显示？你漏了配置
它默认空转，不写配置就永远不显示任何内容。打开 Preferences → Package Settings → StatusBarEnhanced → Settings，右侧用户配置里至少要填一个 items 数组：
[{"type":"encoding","format":"ENC: {value}"},{"type":"line_endings","format":"EOL: {value}"}]
常见坑点：
-
"type"值必须严格匹配文档（如"git_branch"不是"git"或"branch"） - 用
"git_branch"却不显示？确认文件在 Git 仓库根目录下，子目录可能检测失败 - 想显示「已修改」状态？
StatusBarEnhanced默认不支持，得加正则提取git status --porcelain输出，或者换更轻量的Git Status插件 - 每秒轮询 Git 状态会明显拖慢大仓库响应，建议关掉
git_status类字段，或设"interval": 5000
BoxyTheme 主题不生效？检查三处硬编码路径
装完主题只是把文件丢进 Packages/Boxy Theme，不等于启用。失效主因是：
- 没运行
Boxy Theme: Activation命令（Ctrl+Shift+P搜这个并回车） -
Preferences → Settings - User里写了错误的theme路径，比如漏了Packages/前缀，或大小写不对（Boxy Monokai.sublime-theme≠boxy monokai.sublime-theme） -
color_scheme值用了旧格式.tmTheme，新版本只认.sublime-color-scheme，路径可通过Preferences → Color Scheme右键“Copy Path”获取
侧边栏字体看不清？别只调用户设置，得进主题文件改：Ctrl+Shift+P → PackageResourceViewer: Open Resource → 选 Boxy Theme → 找当前皮肤（如 Boxy Tomorrow.sublime-theme）→ 搜 sidebar_label 改 "font.size"，再搜 sidebar_tree 调 "row_padding"。改完保存即生效，不用重启。
