package control必须手动安装，是所有插件的硬性前置条件；需在控制台粘贴官网最新单行代码（以import urllib.request开头），重启后验证package control: install package命令可用且列表非空。
Package Control 必须手动安装，不能跳过
跨平台插件生态依赖 Package Control 正常加载，它不是“可选组件”，而是所有插件的运行前提。Windows/macOS/Linux 上都必须用控制台执行官网单行代码安装，不能靠第三方脚本或“一键安装包”——那些常偷偷改 Preferences.sublime-settings 或注入非标准 Python 模块，导致后续插件报 ImportError: No module named 'package_control'。
常见错误现象：按 Ctrl+Shift+P 输入 Install Package 无响应，或命令面板里搜不到任何插件。这时大概率是 Package Control 加载失败，需检查控制台是否复制了不可见 Unicode 字符（尤其从网页复制时），或代理干扰了 urllib.request.urlopen 请求。
- Windows/macOS/Linux 统一路径：打开控制台
Ctrl+`→ 粘贴官网最新安装代码（以import urllib.request开头）→ 回车 - 成功标志：重启后能呼出
Package Control: Install Package列表，且列表非空 - 失败后别反复重试：删掉
Installed Packages/Package Control.sublime-package，再重装
SideBarEnhancements 是唯一真正跨平台兼容的侧边栏插件
很多用户装了 FileBrowser 或 SideBarFiles 后发现 macOS 上右键菜单错位、Linux 下刷新失效、Windows 高分屏图标糊——这些插件底层调用系统 API 方式不一致，没做三平台适配。
SideBarEnhancements 不依赖系统原生文件对话框，所有操作（新建/重命名/复制路径/刷新）全走 Sublime 自己的 view.run_command() 和 os.path，行为完全一致。它也不改 UI 渲染逻辑，不会和主题、高 DPI 设置冲突。
- 安装后右键菜单多出 “New File”、“New Folder”、“Copy Path”、“Reveal in Finder/Explorer/Nautilus”
- 不抢快捷键：默认无全局绑定，所有功能仅通过右键触发
- 注意别和
ProjectManager同时启用——两者都监听项目变更事件，可能引发重复刷新
Terminus 插件在 Win/macOS/Linux 上命令差异大
Terminus 是目前唯一能在三平台跑通的内建终端，但它的 shell_cmd 参数写法必须按系统区分，硬写成统一值会导致 Linux/macOS 启动失败、Windows 找不到 cmd.exe。
正确做法是在 Preferences → Package Settings → Terminus → Settings 里用条件判断：
{
"shell_configs": [
{
"name": "Command Prompt",
"cmd": ["cmd.exe"],
"env": {},
"platforms": ["windows"]
},
{
"name": "Terminal",
"cmd": ["/bin/bash"],
"env": {"PATH": "/usr/local/bin:$PATH"},
"platforms": ["osx", "linux"]
}
]
}
- Windows 用户别用
PowerShell默认配置——Sublime 的plugin_host对 PS Core 的 stdout 编码处理不稳定，容易卡死 - macOS 上如果终端启动慢，检查是否启用了 iTerm2 的 shell integration，关掉它
- Linux 用户若用 zsh，确保
~/.zshrc里没带交互式提示（如read），否则Terminus会 hang 住
GitGutter 只显示修改状态，不拉取/推送
很多人误以为 GitGutter 能替代命令行 Git，结果在跨平台项目里提交失败还找不到原因。它只读取 .git/index 和工作区文件比对，生成左侧的 +/−/! 标记，所有 Git 操作仍需手动执行。
但它对跨平台协作的关键价值在于：统一显示逻辑。Windows 换行符 \r\n、Linux/macOS 的 \n 在 diff 计算中被正确归一化，不会因换行符差异误标“已修改”。
- 必须确保项目根目录下有
.git文件夹，否则不生效 - 如果标记延迟出现，检查
git status是否卡在钩子（hook）上——GitGutter会等 Git 命令超时（默认 1.5 秒）才 fallback - 别和
SublimeGit共存：两者都监听文件保存事件，可能触发两次 Git 状态刷新，CPU 占用飙升
跨平台插件最危险的坑不是功能缺失，而是“看似正常实则行为不一致”——比如同一份配置在 macOS 上能用，在 Windows 上就丢字符，或者 Linux 下刷新快，macOS 上延迟 2 秒。真正在意稳定性的团队，宁可少装两个炫酷插件，也要确保 Package Control、SideBarEnhancements、GitGutter 这三个底层支撑件在三平台上表现完全一致。
