Package Control装不上需先查控制台报错:ImportError说明脚本与版本不匹配,sublime.installed_packages_path()为空则路径不洁或权限拦截;ST3用户须用官网最新SHA256校验码,macOS需确认Gatekeeper放行,Windows可手动创建Installed Packages目录。

Package Control装不上?先看控制台报什么错
绝大多数插件安装失败,根源不在插件本身,而在Package Control没真正跑起来。打开控制台(Ctrl+` 或 Cmd+`),执行安装命令后如果出现 ImportError: No module named urllib.request,说明你用的是 Sublime Text 2,但粘贴了 ST3 的安装脚本;反之若提示 sublime.installed_packages_path() is None,大概率是安装路径不洁或权限被拦截。
实操建议:
- ST3 用户必须用官网当前有效的 SHA256 校验码——2026 年 7 月起,旧哈希值
'2915d185...'已失效,新值请从packagecontrol.io页面源码里复制sha256字段 - macOS 用户首次运行控制台命令前,务必已完成“仍要打开”操作,否则
urllib.request.urlopen会因 Gatekeeper 拦截静默失败,控制台无报错但文件写不进Installed Packages - Windows 下若
subl命令不可用,Package Control安装脚本里的sublime.installed_packages_path()可能返回空,此时应手动创建目录:%APPDATA%\Sublime Text\Installed Packages
EditorConfig 插件不生效?检查 .editorconfig 文件位置和语法
EditorConfig 不是装完就自动管用的魔法插件。它只读取当前打开文件所在目录及其父级路径中第一个存在的 .editorconfig 文件,并且该文件必须满足两个硬性条件:文件名全小写、无扩展名、位于项目根目录或某一级祖先目录。
常见错误现象:
- 在子目录下打开
src/main.py,但.editorconfig放在project-root/config/里 → 插件完全无视 - 文件命名为
editorconfig或.editorconfig.txt→ 不识别 - 配置项写成
indent_size = 4却漏掉root = true→ 向上遍历时可能被更外层的同名文件覆盖
验证是否加载成功:打开任意文件后,在状态栏左下角查看是否显示 indent: 4 spaces 类提示;没有则说明未命中配置。
Python 开发必装插件:SublimeREPL 和 Anaconda 的分工陷阱
SublimeREPL 和 Anaconda 都支持 Python 补全与 lint,但底层机制完全不同,混用容易冲突。前者是进程级交互终端,后者是基于 pycodestyle 和 pyflakes 的静态分析器。
使用场景与参数差异:
- 需要实时执行代码块、调试变量值、调用
matplotlib绘图 → 必用SublimeREPL,启动后默认走系统python,如需指定虚拟环境,得改SublimeREPL.sublime-settings里的"python": {"cmd": ["path/to/venv/bin/python"]} - 专注 PEP8 检查、类型提示(
typing)、函数签名提示 → 选Anaconda,但它默认禁用auto-complete功能,需手动开启"auto_complete": true,否则补全只在.后触发 - 两者都启用时,
Anaconda的 lint 结果会覆盖SublimeREPL的运行输出区域,造成误判
SideBarEnhancements 右键菜单失效?别动 Packages 目录结构
这个插件依赖 Sublime Text 对 Packages/SideBarEnhancements 目录的精确识别。一旦你手动把下载的 zip 解压进 Packages 后又重命名文件夹(比如改成 SideBarEnhancements-master),或者用 Git 克隆到 Packages 下却保留了 .git 子目录,右键菜单就会消失,且控制台不报错。
正确做法只有两种:
- 通过
Package Control: Install Package搜索安装,让Package Control自动解压并命名 - 手动安装时,确保解压后文件夹名严格为
SideBarEnhancements,内部必须包含side_bar.py和Default.sublime-menu,且不能有嵌套层级(即 zip 解压后直接丢进Packages,不要多一层目录)
插件功能看似简单,但它的上下文菜单是靠 Sublime Text 在启动时扫描 Packages/*/Default.sublime-menu 文件注册的,路径错一毫,整个菜单就白搭。

















