package control安装失败三大主因：一是python版本不匹配（st3旧版用python2.6，代码适配python3）；二是权限问题（windows需避免uac拦截，macos需安装shell commands，linux应选官网.deb包）；三是路径错误（手动插件须放用户级packages目录，非安装目录）。
Package Control 安装失败的三个常见原因
直接复制粘贴控制台代码却提示 ImportError: No module named urllib.request 或 ssl.SSLError，基本是 Python 版本或网络代理问题。Sublime Text 3 内置的是 Python 3.3+ 运行时，但部分旧版（如 Build 3126）仍用 Python 2.6，而控制台代码已适配 Python 3；macOS 上若系统 Python 被 Homebrew 修改过，也可能干扰内置解释器。
- Windows 用户遇到
Permission denied写入Package Control.sublime-package，说明 Sublime 没有以管理员权限运行，或安装路径在Program Files下被 UAC 拦截 —— 不要强行提权，改用便携模式（解压版）或重装到用户目录（如C:\Users\YourName\Sublime Text） - macOS 用户执行完安装代码无反应，检查是否跳过了「Shell Commands」安装步骤：菜单
Tools → Command Palette → Shell Commands → Install Shell Commands，否则subl命令不可用，Package Control 初始化也会延迟或失败 - Linux 用户用
apt install sublime-text装的版本，sublime.installed_packages_path()返回路径可能不标准（比如指向/usr/lib/sublime-text/Packages），导致插件写入失败 —— 推荐从官网下载.deb包手动安装，或用 Snap 版本（路径统一）
手动安装插件时 Packages 目录的真实位置
很多人按教程打开 Preferences → Browse Packages 却看到空文件夹，是因为 Sublime 默认只显示用户级 Packages，而系统级插件（如自带的 Default）藏在另一处。真正要放手动插件的地方是用户目录下的 Packages，不是程序安装目录。
- Windows：
%APPDATA%\Sublime Text\Packages（不是Program Files\Sublime Text\Packages） - macOS：
~/Library/Application Support/Sublime Text/Packages（注意是Application Support，不是Applications） - Linux：
~/.config/sublime-text/Packages（XDG 标准路径，不是/opt/sublime_text/Packages） - 插件文件夹名必须与插件 GitHub 仓库名一致（如
editorconfig-sublime不能改成EditorConfig），否则 Sublime 启动时不加载
插件安装后不生效的隐藏判断条件
点了 Install、没报错、插件文件也出现在 Packages 目录里，但快捷键没反应、菜单不出现 —— 很可能插件依赖未满足，或触发条件不匹配。
-
BracketHighlighter需要当前文件有明确语法定义（selector），如果文件是纯文本（Plain text），它不会激活；右下角状态栏点开语言名，手动选HTML或Python再试 -
GitGutter要求项目根目录存在.git文件夹，且 Sublime 必须在该目录下启动（subl .），而非只打开单个文件（subl file.py） -
Emmet在 Sublime Text 4 中默认禁用 HTML/CSS 的自动展开，需在Preferences → Package Settings → Emmet → Settings中把"disabled": true改为false，并确认"syntax_scopes"包含"text.html.basic"
升级或卸载插件时容易误操作的路径陷阱
通过 Package Control 卸载插件后，Packages 目录里对应文件夹还在，甚至残留 .pyc 缓存 —— 这会导致下次安装同名插件时加载旧逻辑，行为异常。
- 不要只靠菜单
Package Control → Remove Package就以为清理干净；执行后务必手动进Packages目录，删掉插件同名文件夹和任何.pyc文件 - 升级失败（如
EditorConfig升级后缩进失效），检查是否同时存在EditorConfig和EditorConfig-Sublime两个文件夹 —— 后者是旧版命名，会冲突，必须删掉一个 - 修改插件源码调试时，改完
.py文件别忘了删掉同目录下生成的__pycache__文件夹，否则 Sublime 可能继续运行缓存字节码
