Package Control需手动安装且90%失败源于网络问题，应优先执行官网最新脚本、切换国内镜像源、校准系统时间、确保ST版本匹配并重启生效。
Package Control 不是开箱即用的组件，必须手动安装且极易因网络问题失败。装不上不是你操作错了，而是脚本卡在 TLS 握手、域名解析或证书校验上——尤其在国内环境，90% 的“安装失败”本质是连不上 packagecontrol.io。
执行安装命令前先确认控制台能用
按 Ctrl+`（反引号）调出 Sublime 控制台，别直接粘代码。如果控制台空白或报错 NameError: name 'sublime' is not defined，说明 Sublime 还没完成初始化，等几秒再试。
常见误操作：
- 复制时带了中文空格或全角符号，导致语法错误
- 用了老版本脚本（ST4 必须含
hashlib.sha256校验），只显示Success!但后续无法加载插件列表 - 企业/校园网 DNS 污染，
packagecontrol.io解析成错误 IP
ST4 推荐用这行（已适配最新证书和域名）：
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/Package%20Control.sublime-package'))
手动安装 Package Control 的路径和权限问题
脚本失败后别反复重试，直接离线安装更可靠：
- 去
https://packagecontrol.io/Package%20Control.sublime-package下载文件（注意 URL 中有空格编码） - Windows 路径是
%APPDATA%\Sublime Text 4\Installed Packages\ - macOS 路径是
~/Library/Application Support/Sublime Text 4/Installed Packages/ - Linux 路径是
~/.config/sublime-text-4/Installed Packages/ - 部分公司电脑禁用该目录写入权限，需以管理员身份运行 Sublime 或换用户目录
放进目录后必须重启 Sublime，否则不会加载。
装完 Package Control 怎么才算真正生效
菜单里出现 Preferences → Package Control ≠ 成功。真通路只有两个验证点：
- 按
Ctrl+Shift+P输入Package Control: List Packages→ 返回空列表（不是报错、不是卡住） - 输入
Package Control: Install Package→ 左下角出现Fetching list of available packages（首次约 5–10 秒，公司网建议切手机热点） - 若命令面板搜不到这些命令，进
Installed Packages/删掉所有含Package Control字样的文件，再重装
插件装进去却不工作？重点查这三处
Sublime 的插件激活逻辑非常具体，不是“放进去就干活”：
- 作用域不匹配：比如
Vue Syntax Highlight只在.vue文件或text.html.vue作用域下生效，打开普通.html文件时完全静默 -
ignored_packages配置项屏蔽了它：打开Preferences → Settings，右侧用户配置中检查是否有类似"ignored_packages": ["Emmet"]的条目 - 路径放错位置：
Emmet.sublime-package必须扔进Installed Packages/；而解压后的Emmet/文件夹必须整体拖进Packages/（不是子目录！） - 大小写敏感：
emmet和Emmet是两个不同插件名，加载时严格区分
最常被忽略的是：插件配置必须写在 Packages/User/xxx.sublime-settings，写在 Packages/xxx/ 下会被升级覆盖或直接忽略。
