Sublime怎么解决Package Control报错 Sublime手动安装PC插件【解决】

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/ 目录。这两个动作看似微小，却直接决定整个流程成败。