package control安装失败典型现象是控制台无响应、报importerror或校验失败,修复路径为:先确认st4版本,再用官网含urllib.request的最新脚本执行;若失败则手动下载package control.sublime-package放入sublime.installed_packages_path()返回目录并彻底重启。

Package Control 安装失败的典型现象和修复路径
控制台执行安装命令后没反应、报 ImportError: No module named 'urllib.request' 或弹出 Error validating download,基本是环境或代码版本错配。Sublime Text 4 默认用 Python 3.8+,但网上流传的旧版安装脚本(比如含 import urllib2 的)在 ST4 里直接失效。
- 务必使用官网当前有效脚本:打开 packagecontrol.io/installation,复制以
import urllib.request开头的那一段(截至 2026 年 8 月仍为 SHA256 校验 +http://packagecontrol.io/域名) - 粘贴前先清空控制台历史,避免残留字符干扰;粘贴后回车,等待几秒——不要连按回车
- 若提示校验失败,大概率是代理或 DNS 污染导致下载了错误文件,可手动下载
Package Control.sublime-package放到sublime.installed_packages_path()返回的目录下(在控制台输入该函数并回车即可看到路径)
SideBarEnhancements 和 GitGutter 这两个插件为什么必须装
不是“功能炫酷才装”,而是解决新手最卡壳的两个操作断点:找不到文件在哪、改了但不知道改了啥。
-
SideBarEnhancements让右键菜单支持“新建文件/文件夹”“在资源管理器中打开”“复制文件路径”,省去手动建目录、切窗口、拼路径的麻烦;它不改 UI 渲染逻辑,不会和其他插件抢焦点 -
GitGutter在行号旁显示+/-/→图标,直观反映当前文件相对于 Git HEAD 的增删改状态;不需要配置仓库,只要文件夹里有.git就自动生效,对刚学 Git 的人属于“无感提示” - 二者都无快捷键冲突,默认不启用额外命令,装完重启即用,不需调设置
别碰“汉化包”和“激活补丁”的真实代价
表面上只是界面变中文、弹窗消失,实际会破坏 Sublime 的插件加载链路。
- 所谓“汉化包”往往直接覆盖
Default/Preferences.sublime-settings,导致后续所有用户级配置(如字体大小、制表符宽度)被重置 - “免激活补丁”篡改
plugin_host进程的二进制入口,ST4 启动时校验失败会静默禁用全部插件,表现为Ctrl+Shift+P呼不出命令面板、侧边栏右键菜单变回原生简陋版 - 中文界面完全可用语言包实现:Preferences → Package Settings → Locale → Set Language → Chinese (Simplified),不碰 core 文件,升级安全
新手装插件最容易忽略的验证动作
装完就以为完事,结果发现快捷键没反应、右键没新选项——其实只是没重启或没触发加载。
- 每个插件安装后,必须关闭并重新打开 Sublime Text,否则
plugin_loaded()钩子不触发,插件处于“已存在但未激活”状态 - 验证
SideBarEnhancements是否生效:右键侧边栏空白处,应出现 “New File”“New Folder” 等选项;没有?说明插件没加载,检查是否被其他插件同名文件覆盖(如手动拷贝过旧版) - 验证
GitGutter:打开一个 Git 仓库里的文件,修改几行再保存,看行号左侧是否有变化;没变化?确认项目根目录下真有.git文件夹,且 Sublime 是从该目录启动(不是双击单个文件)











