ST3用户必须使用带哈希校验的老脚本，不能套用ST4命令；需通过Help→About确认版本，用Ctrl+`调出控制台执行对应脚本，安装后重启并验证Ctrl+Shift+P能否调出Package Control命令。
ST3用户必须用带哈希校验的老脚本，不能套用ST4命令
Sublime Text 3（ST3）和ST4的Package Control安装机制完全不同：ST3脚本依赖硬编码的SHA256哈希值校验，且默认走HTTP（虽已强制重定向HTTPS，但手动改http://会触发更隐蔽中断）；ST4则必须用packagecontrol.io/installation.py动态脚本。如果你Help → About里显示的是Sublime Text 3，直接粘贴ST4命令会报module 'urllib' has no attribute 'request'——这不是网络问题，是Python模块路径不兼容。
- ST3可靠脚本开头哈希为
bf11abc3或7183a2d3，完整地址来自https://packagecontrol.io/页面顶部（不是第三方博客里带“2022年更新”字样的旧存档） - 别信“复制粘贴即装好”的说法：ST3脚本执行后控制台可能只显示
reloading plugin，必须等满5秒看状态栏是否出现Package Control: Successfully installed Package Control - 如果卡在
reloading plugin且无后续提示，大概率是DNS慢或TLS握手失败，此时应立刻切手动安装，而非反复重试
手动安装时Installed Packages路径容易错位
ST3和ST4的sublime.installed_packages_path()返回路径不同：ST3常见于~/Library/Application Support/Sublime Text 3/Installed Packages/（macOS）或%APPDATA%\Sublime Text 3\Installed Packages\（Windows），而ST4默认是Sublime Text/Installed Packages/（无版本号）。直接按网上教程“退一级进Installed Packages”可能进错目录——尤其当系统里同时装过ST3和ST4时，残留路径更易混淆。
- 最稳妥方式：在控制台执行
sublime.installed_packages_path()，复制返回的真实路径，用文件管理器直接打开 - 下载地址必须是
https://packagecontrol.io/Package%20Control.sublime-package（注意空格是%20，不是下划线或删空格） - 文件名必须严格为
Package Control.sublime-package，拖入后不要解压、不要改后缀、不要放进Packages/子目录
验证是否真生效，别被Preferences菜单骗了
很多人看到Preferences → Package Settings → Package Control就以为装成了，其实那是旧版残留UI。ST3环境下真正生效的唯一证据是命令面板能调出并执行核心命令——哪怕远程仓库还没同步，只要命令存在，框架就算跑起来了。
- 重启后按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: List Packages，能弹出列表（哪怕为空）才算成功 - 若输入
Package Control:后无任何补全，说明Package Control.sublime-package没被加载，检查文件是否放对路径、后缀名是否完整、是否还有旧版残留文件（如Package Control.sublime-package.bak） - 首次执行
Package Control: Install Package时右下角会显示Fetching list of available packages，这是在拉取远程索引，需5–10秒，不是卡死
ST3装完后同步仓库常被忽略
手动安装或脚本安装成功后，ST3不会自动拉取插件索引。你按Package Control: Install Package搜不到Emmet、ChineseLocalizations等常用插件，不是插件不存在，而是本地缓存为空。
- 必须手动执行
Package Control: Synchronize Packages（命令面板输入即可），等右下角提示完成 - 同步过程依赖网络，如果公司/校园网屏蔽
packagecontrol.io，会一直卡在“Fetching”，此时需配代理或换网络 - 同步完成后，再执行
Package Control: Install Package才能看到完整插件列表
