sublime怎么解决sftp连接失败_sublime远程服务器连接权限设置【方案】_网络技术

连接失败时先看错误类型再排查：Connection timeout查网络层，Authentication failed查凭据或密钥格式（Windows需.ppk），Host key verification failed是服务器公钥变更；远程目录无写权限、ignore_regexes正则误配也会导致静默失败。

连接失败时先看错误类型，再决定查哪一层

Sublime 的 SFTP 插件报错不统一，但常见错误基本就三类：Connection timeout、Authentication failed、Host key verification failed。它们对应完全不同的排查路径：

Connection timeout：网络层问题，重点查 host、port、防火墙、SSH 服务是否真在运行（不是只开了 FTP）
Authentication failed：凭据或认证方式错，比如用了 OpenSSH 私钥却没转成 .ppk（Windows 下必须），或密码输错但被缓存了旧会话
Host key verification failed：服务器 SSH 公钥变了（重装系统、换 IP、虚拟机快照回滚都可能触发），不是安全漏洞，是插件默认严格校验

Windows 下用密钥登录必须转 .ppk，OpenSSH 私钥直接填会失败

Sublime 的 SFTP 插件在 Windows 上不认原生 id_rsa，只支持 PuTTY 格式（.ppk）。哪怕你用 ssh-keygen 生成了密钥，也得用 PuTTYgen 转一次：

打开 PuTTYgen → Load → 选你的 id_rsa（注意不是 id_rsa.pub）
点击 Save private key，保存为 id_rsa.ppk
在 sftp-config.json 中写："ssh_key_file": "C:/path/to/id_rsa.ppk"（注意 Windows 路径用正斜杠或双反斜杠）

如果跳过这步，配置里写 "private_key": "/home/user/.ssh/id_rsa" 是无效的，插件根本不会读。

远程目录权限不够会导致上传静默失败，不是报错而是卡住

即使连接成功、认证通过，SFTP 上传文件也可能“看起来没反应”——实际是远程目录没有写权限。典型表现是：Ctrl+S 后无提示，右键 SFTP → Upload File 也无响应，输出面板（Tools → SFTP → Show Output）里只显示 uploading... 然后停住。

检查 remote_path 对应的服务器路径是否存在：ls -ld /var/www/html/project
确认用户对该目录有写权限：sudo chown -R $USER:$USER /var/www/html/project 或 sudo chmod 755 /var/www/html/project
如果用的是 root 用户，确保没启用 requiretty（某些云主机默认开启，会阻断非交互式 SFTP 写入）

忽略规则写错会让整个项目同步失效，尤其注意正则末尾斜杠

ignore_regexes 是数组，每项是正则字符串，但 Sublime 的匹配逻辑很“字面”：它匹配的是**完整路径相对 remote_path 的部分**。比如你设了 "remote_path": "/var/www/html"，本地改了 src/js/main.js，那插件实际比对的是 src/js/main.js 这个字符串。

想忽略整个 node_modules 文件夹，要写 "node_modules/"（带斜杠），否则 "node_modules" 会误杀 package.json 里含该字符串的所有行
想忽略所有隐藏文件，"^\\." 比 "\\.git" 更安全；而 "\\.git*" 会意外匹配 gitlab-ci.yml
别把 sftp-config.json 加进忽略列表——它本身是配置文件，删了就断连

最稳妥的做法是先清空 ignore_regexes，确认基础同步正常，再一条条加规则并测试。

真正卡住人的从来不是“怎么连”，而是“连上了为什么不动”。权限、密钥格式、正则边界、主机密钥变更——这些点看似零碎，但每个都足以让同步彻底静默失效。动手前先看输出面板，比瞎猜快十倍。

# html # sublime # js # git # json # node # windows # 防火墙 # 虚拟机 # ai # win # gitlab # 字符串 # private # var

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】