SFTP插件需手动触发配置,右键文件夹选“Map to Remote”;host填IP/域名,user填SSH用户名,password留空配private_key路径;上传失败常见于密钥权限非600或sshd_config未启用认证。

Sublime Text 安装 SFTP 插件后打不开配置文件
插件安装成功后,SFTP 不会自动弹出配置窗口,必须手动触发。常见错误是右键菜单里找不到 SFTP 选项——这通常是因为当前没有打开任何文件或文件夹,或者项目未正确加载。
- 确保已通过
Project → Add Folder to Project...添加了本地工作目录 - 右键点击侧边栏中的文件夹(不是空白处),才能看到
SFTP → Map to Remote... - 如果仍不显示,检查是否安装的是官方
SFTP插件(作者为wbond),而非名字相似的仿制品 - 插件安装后需重启 Sublime Text 才能完全生效
配置 SFTP 连接时 host、user、password 填什么
这些字段直接对应 SSH 登录信息,但要注意几个关键细节:
-
host填服务器公网 IP 或域名,不要加ssh://前缀 -
user是 VPS 上你用来登录的用户名(如root或普通用户),不是面板账号 -
password可留空——如果你用密钥登录,就填private_key路径(如~/.ssh/id_rsa),Windows 下写绝对路径如C:\\Users\\xxx\\.ssh\\id_rsa -
remote_path必须以/开头,且是远程服务器上的绝对路径(如/var/www/html/),不能是相对路径
保存文件后没自动上传,或提示 Permission denied (publickey)
这是最常卡住的地方:SFTP 插件默认走 SSH 协议,但权限和认证方式稍有偏差就失败。
- 确认远程服务器的
sshd_config允许密码或密钥登录(PasswordAuthentication yes或PubkeyAuthentication yes) - 密钥文件权限必须是
600(Linux/macOS),否则 OpenSSH 拒绝读取;Windows 用户注意路径中反斜杠要双写或用正斜杠 - 插件不会复用终端里已有的 ssh-agent,所以即使你在命令行能免密登录,SFTP 插件仍可能失败——要么配
private_key,要么在配置里加"ssh_args": ["-o", "IdentitiesOnly=yes"] - 上传失败时,按
Ctrl+Shift+P输入SFTP: Show Console查看完整错误,比弹窗提示更具体
编辑远程文件时如何避免覆盖或冲突
SFTP 插件本身不带锁机制或版本比对,它只是单向同步(本地→远程),一旦多人协作或服务端文件被其他方式修改,极易丢内容。
- 启用
"sync_down_on_open": true,每次打开文件前先从服务器拉取最新版 - 开启
"confirm_overwrite_newer": true,本地文件比远程旧时会弹窗提醒 - 别依赖
"upload_on_save": true做生产环境部署——它不校验执行结果,上传失败也不会回滚 - 真正需要安全编辑的场景,建议改用
sshfs挂载远程目录,再用 Sublime 打开挂载点,这样文件系统层统一处理权限与一致性
umask 导致的文件不可写上。










