Package Control安装失败主因有四：脚本过期或校验失败、ST3/ST4模块混用、安装路径错误（须放installed_packages_path()目录并重启）、网络超时需换镜像源或代理；旧ST3（Build
Package Control 控制台安装报错：脚本失效或校验失败
最常见的情况是粘贴了过期的安装脚本，或版本不匹配导致 hashlib.sha256 校验失败（比如提示 Error validating download (got xxx instead of yyy)）。Sublime Text 3 和 4 使用的 Python 模块不同（urllib2 vs urllib.request），混用会直接报 NameError 或 AttributeError。
- ST3 用户请务必使用含
urllib.request的脚本，且 SHA256 哈希值需与官网当前一致（例如h = '7183a2d3e96f11eeadd761d777e62404'） - ST4 用户建议直接从 packagecontrol.io/installation 复制最新脚本——页面会自动识别版本并给出对应代码
- 复制时注意不要带空格、换行或中文标点；控制台中执行前可先输入
print(sublime.version())确认版本号
手动放入 Package Control.sublime-package 文件仍不生效
文件放对位置但菜单里没出现 Package Control，大概率是路径错误或未触发加载。Sublime 不会扫描子目录，也不接受重命名后的包文件。
- 正确路径是：
sublime.installed_packages_path()返回的目录（通常为Packages/Installed Packages/，不是Packages/User/） - 验证方式：在控制台运行
print(sublime.installed_packages_path())，然后把下载好的Package Control.sublime-package直接丢进去 - 必须重启 Sublime 才会加载——仅刷新或重载插件无效
- 若仍无反应，检查文件权限（尤其 macOS/Linux 下是否被系统拦截），或尝试右键用「以管理员身份运行」启动
安装后 Package Control: Install Package 卡住或报网络超时
这说明 Package Control 已装上，但连不上源服务器。默认的 https://packagecontrol.io/channel_v3.json 在国内常被阻断或 DNS 污染。
- 打开命令面板 → 输入
Package Control: Settings - User→ 添加或修改"channels"字段 - 推荐镜像源（实测可用）：
"https://gitee.com/akira-cn/package_control_channel/raw/master/channel.json" - 如公司网络需代理，同时加
"http_proxy"和"https_proxy"（格式如"http://127.0.0.1:7890"），注意协议必须小写 - 改完保存，**必须重启 Sublime** —— 设置不会热重载
旧版 ST3（Build
这类版本内置的 Python 缺少 SNI 支持，无法完成 HTTPS 握手，所有自动安装都会卡在 urlopen。强行升级或换镜像都无效。
- 唯一可靠解法：升级到 ST3 Build 3211+ 或直接换用 ST4（官方已停止维护旧 ST3）
- 若因 license 或兼容性不能升级，只能退回到纯手动流程：下载插件 ZIP → 解压到
Packages/插件名/→ 确保文件夹名与插件要求完全一致（大小写敏感） - 别信“打补丁”“替换 DLL”等方案——Sublime 的二进制封闭，第三方 patch 极易导致崩溃
实际操作中最容易被跳过的一步，是改完设置后忘记重启 Sublime；而最容易白忙活的，是把 .sublime-package 文件错扔进了 User/ 目录。这两个动作看似微小，却直接决定整个流程成败。
