package control 是 sublime text 硬性前置依赖，未安装则命令面板无 install package；st4 用户须手动下载最新 .sublime-package 文件并正确放置至 installed packages/ 目录，重启后执行 package control: list packages 成功返回列表才算安装完成。
Package Control 必须先装，不是可选而是硬性前置
没装 Package Control 就去搜插件，命令面板里根本不会出现 Install Package——这不是你操作慢，是框架压根没搭起来。ST4 用户尤其要注意：官网脚本已更新，旧版 Python 安装代码（含 SHA256 校验值）在 2026 年大概率失效，控制台静默无反应或只刷 reloading plugin 都算失败。
推荐做法：
- 关掉 Sublime Text，清空
Installed Packages/目录下所有带Package Control字样的文件 - 手动下载
Package Control.sublime-package（地址：https://packagecontrol.io/Package%20Control.sublime-package） - 拖进
Installed Packages/（注意：不是Packages/，且不解压、不改名） - 重启后按
Ctrl+Shift+P，输入Package Control: List Packages能执行并返回列表才算真成功
插件安装卡在 “Loading Repositories”？别等，先查网络和证书
输入 Package Control: Install Package 后左下角一直显示 Loading Repositories，大概率不是仓库没加载完，而是 HTTPS 请求被拦截或超时。ST4 默认走 https://packagecontrol.io，某些企业网络、代理或国产杀毒软件会主动阻断该域名或校验证书失败。
临时绕过方式：
- 打开
Preferences → Package Settings → Package Control → Settings - 在右侧（User）配置中加一行：
"http_timeout": 15（默认是 30，有时太长反而卡住） - 再加一行：
"channels": ["https://packagecontrol.io/channel_v3.json"]（显式指定，避免自动跳转出错） - 保存后重试；若仍失败，换手机热点测试，确认是否纯网络问题
项目级主题和设置怎么生效？路径和格式必须严格匹配
新建 .sublime-project 文件后主题不生效，常见原因是 color_scheme 值写错。ST4 不认旧的 .tmTheme 格式，只接受 .sublime-color-scheme，而且路径必须完整、大小写敏感。
正确获取方式：
- 菜单
Preferences → Color Scheme，点开任意主题 - 右键该主题项 →
Copy Path，粘贴到项目文件的settings里 -
folders中的path推荐用"."（相对路径），避免绝对路径跨机器失效 - 项目文件必须通过
Project → Save Project As生成，直接新建文本保存为 .sublime-project 不会被识别
字体、缩进、空格可视化这些基础设置，改错位置就白配
很多人把配置写进左侧 Default 设置里，结果一重启全丢——因为那是只读模板，任何修改都会被下次升级覆盖。所有个性化必须写在右侧 User 的 JSON 里。
常用项建议直接复制粘贴（注意末尾逗号）：
{
"font_size": 13,
"tab_size": 4,
"translate_tabs_to_spaces": true,
"highlight_line": true,
"draw_white_space": "all"
}
改完立刻生效，不用重启；但 draw_white_space 设为 "all" 会同时显示空格和制表符，对排查混用缩进特别有用，不过初学者可能觉得界面杂乱，可先设为 "selection" 过渡。
真正容易被忽略的是：项目级设置会覆盖 User 设置，但仅限于该项目窗口内。新开一个无项目窗口，还是走 User 配置——这点常被当成“设置没生效”，其实是预期行为。
