“一键安装插件”根本不存在，因为Sublime Text自身无插件管理能力，必须先安装Package Control这一底层框架，再通过命令面板搜索安装，三步缺一不可。
Package Control 没装好，所谓“一键运行插件”根本不存在——所有插件安装都依赖它，跳过这步，Ctrl+Shift+P 里连 Package Control: Install Package 都不会出现。
为什么“一键安装插件”根本不存在？
Sublime Text 本身不带任何插件管理能力。网上说的“一键”，其实是把三步操作（装 Package Control → 调命令面板 → 搜名字安装）压缩成一个说法。但每一步都不可省略，且任意一步失败，后续就卡死。
-
Package Control不是插件，是底层框架；没它，DashDoc、GitGutter、Emmet全部无法通过标准流程安装 - 菜单里“Preferences → Package Control”选项只有装完才出现，别试图从这里点进去——那是结果，不是入口
- 控制台执行脚本后只显示
reloading plugin或无输出，不代表成功；必须看到Package Control installed或Success!才算落地
装不上 Package Control？先确认执行方式对不对
失败主因从来不是代码错，而是入口或环境问题。
- 必须用
Ctrl+`（Esc 下方反引号键）调出底部 Python 控制台，粘贴官网最新 HTTPS 脚本并回车；旧链接http://sublime.wbond.net已彻底失效 - 若快捷键被输入法拦截（如 QQ 拼音），需先关闭其热键设置，否则
Ctrl+`根本打不开控制台 - 复制脚本时容易带入不可见 Unicode 字符（尤其从网页/微信粘贴），建议用纯文本编辑器中转一次再粘贴
- 路径含中文或空格（比如装在
C:\Program Files\或D:\我的软件\Sublime Text）会导致urllib权限失败，建议重装到C:\SublimeText这类干净路径
插件装了但“一键运行”没反应？检查这三点
比如你装了 DashDoc 想按 Ctrl+h 查文档，或装了 ConvertToUTF8 想自动解乱码，却毫无反应——大概率不是插件坏，而是配置断在中间。
-
快捷键没绑定：从
DashDoc 2.0开始，不再自带默认快捷键。必须手动进Preferences → Key Bindings，在 User 文件里加一行：[{"keys": ["ctrl+h"], "command": "dash_doc"}] -
被
ignored_packages屏蔽：打开Preferences → Settings – User，检查是否有"ignored_packages": ["DashDoc", "Emmet"]这类字段；如果有，删掉对应插件名，保存后**彻底退出 Sublime**（Windows 杀光subl.exe，macOS 用 Dock 右键 Quit）再重启 -
语法作用域不匹配：很多插件只在特定文件类型下激活。例如
GitGutter默认只在source.git或已提交 Git 仓库的文件中显示图标；开个空白.txt文件时它就是“不工作”的——这不是 bug，是设计
离线或网络受限时怎么装插件？
国内直连 packagecontrol.io 稳定性差，Installing... 卡住不动是常态。科学上网是最简方案；若不可行，走手动路径更可靠。
-
Package Control必须用.sublime-package文件直投：Preferences → Browse Packages…→ 上一级进Installed Packages/→ 把下载好的Package Control.sublime-package文件拖进去（不解压、不改名、不嵌套） - GitHub 插件 ZIP 包解压后，一定砍掉顶层的
PluginName-main或PluginName-master文件夹；只取里面含__init__.py或主模块（如git_gutter.py）的子目录，重命名为GitGutter这类干净名称，再拖进Packages/根目录 - 装完务必重启并查控制台：
Ctrl+`输入sublime.log_commands(True)，然后试触发插件命令；如果控制台没打印对应command: dash_doc，说明根本没加载——回头检查文件夹名大小写、Python 版本兼容性（ST4 要求插件适配sublime_pluginv4 API）
