必须先安装package control，否则sftp插件无法安装；需通过ctrl+shift+p执行install package安装wbond版sftp，装完必须重启sublime，且仅支持st3（st4需用sftp-next）。
必须先装 Package Control，否则 SFTP 插件根本装不上。 这不是可选项，是硬性前置条件。很多人卡在“Ctrl+Shift+P 没反应”或“Install Package 找不到”，本质都是 Package Control 没装成功。
Package Control 安装失败的典型表现和修复
控制台执行安装脚本后没输出 OK、报 urllib.error.URLError、重启后命令面板仍不可用，基本都指向网络或路径问题：
- 国内直连
packagecontrol.io失败时，把脚本里的 URL 替换成https://ghproxy.com/https://packagecontrol.io/ - Mac 上提示
Permission denied，别用sudo启动 Sublime，而是手动把Package Control.sublime-package放进~/Library/Application Support/Sublime Text/Packages/Installed Packages/ - 装完不生效？检查
Preferences → Package Settings → Package Control → Settings – User里有没有把"Package Control"写进"ignored_packages"
SFTP 插件安装后没出现右键菜单
插件装完但右键没有 SFTP/FTP 选项，常见原因不是插件没装好，而是 Sublime 没识别到它已启用：
- 确认插件名是
SFTP（注意大小写），不是sftp或Sftp—— 插件名错一个字母就不会加载 - 打开
Preferences → Package Settings → SFTP → Settings – Default，看是否能打开配置文件；打不开说明插件未激活 - 某些 Sublime 版本（如 Build 4143+）会因插件签名机制拒绝加载旧版 SFTP，需去 GitHub 下载最新 release 的
.sublime-package手动覆盖
sftp-config.json 配置后连接失败的三个关键点
配置文件语法没错、账号密码也对，但还是连不上，大概率栽在这三处：
-
"host"值不能带ssh://或端口（如ssh://example.com:2222），只填"example.com"；端口单独配"port": 2222 -
"remote_path"必须以/开头且为绝对路径（如"/var/www/html"），不能写成"www/html"或"./www/html" - 启用了
"upload_on_save": true却没反应？检查当前文件是否属于已映射的文件夹——只有右键该文件夹选过Map to Remote，其子文件才受控
最常被忽略的是：SFTP 插件首次连接时会弹出主机指纹确认框，如果后台运行或窗口被遮挡，这个弹窗会卡住整个同步流程，看起来就像“没反应”。务必盯住屏幕右下角，看到弹窗就点 Yes。
