Sublime怎么配置远程FTP上传？Sublime安装SFTP插件连接服务器

Sublime Text需通过Package Control安装wbond版SFTP插件并配置sftp-config.json（含host、user、ssh_key_file、remote_path等字段），开启upload_on_sa ve方可实现保存即上传，仅支持SFTP协议，不兼容纯FTP。

开门见山，先说一个核心事实：Sublime Text 编辑器本身，压根就不支持 FTP 或 SFTP 上传功能。所以，网上常说的“配置FTP上传”，在 Sublime 里其实是个技术上的“代称”——它只能通过 SFTP（也就是基于 SSH 的文件传输协议）来实现。而实现这一切，必须依赖一个第三方插件。目前，唯一靠谱且仍在维护的解决方案，就是 wbond 开发的 SFTP 插件。但这里有个关键限制：这个插件只认 SFTP，完全不兼容传统的 FTP 协议。如果你的服务器只开了 FTP 端口，那很抱歉，这条路从一开始就走不通。

Sublime 安装 SFTP 插件必须用 Package Control，手动放文件夹无效

很多朋友图省事，喜欢手动下载插件压缩包，解压到 Packages/ 目录。但这一招对 SFTP 插件基本无效，结果往往是菜单不出现、右键找不到选项、命令面板也搜不到——插件根本没被正确初始化。

• 第一步，先确保你的 Sublime Text 已经安装了 Package Control。怎么确认？按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），在弹出的命令面板里输入 Install Package Control 看看，如果已经安装，这一步可以跳过。
• 安装插件，同样打开命令面板，输入 Package Control: Install Package 并回车。
• 稍等片刻，待插件列表加载完成后，搜索 SFTP。这里要睁大眼睛：**务必选择作者显示为 wbond 的那个**。列表里可能会有一些名字相似的仿品，比如 sftp-client 或早已停止更新的 FTPSync，千万别选错。
• 安装完成后，记得重启一次 Sublime Text。否则，Project 菜单和右键菜单里很可能不会出现 SFTP 的相关选项。

sftp-config.json 必须放在项目根目录，字段错一个就静默失败

配置文件的摆放位置和内容，是新手最容易栽跟头的地方。这个插件有个“坏习惯”：它遇到配置错误时，往往不会弹出醒目的红框报错，只在状态栏一闪而过一行小字，然后一切如常，让你误以为配置没问题。其实，它已经“静默失败”了。

首先，配置文件的名字必须是 sftp-config.json，编码格式推荐 UTF-8 无 BOM。其次，它必须放在你通过 Project → Add Folder to Project 添加到 Sublime 的本地项目根目录下。放在别处，插件根本找不到。

• "host"：这里只填服务器的 IP 地址或域名，**千万别画蛇添足加上 ftp:// 或 sftp:// 前缀**。正确示例："host": "192.168.1.100"。
• "user"：填写的是 SSH 登录用户名，可不是你网站控制面板的账号。如果使用密钥登录，请务必删除或留空 "password" 字段，否则会冲突。
• "ssh_key_file"：私钥文件的路径，这里要求是绝对路径。Linux 或 macOS 下类似 "/home/you/.ssh/id_rsa"，Windows 下则是 "C:/Users/You/.ssh/id_rsa"（注意，使用正斜杠 / 通常兼容性更好）。
• "remote_path"：服务器上的远程路径，必须以 / 开头的绝对路径，例如 "/var/www/html/"。路径结尾加不加斜杠，会影响文件上传的具体位置，需要根据实际情况调整。
• "port"：默认是 22。如果你的服务器修改过 SSH 端口，这里必须明确写出来，比如 "port": 2222。

upload_on_sa ve 不生效？大概率是项目没绑定或路径不匹配

明明在配置里设置了 "upload_on_sa ve": true，保存文件时却毫无反应？别急着怀疑插件坏了，问题很可能出在“绑定”上——Sublime 根本不知道当前编辑的文件，应该同步到远程服务器的哪个位置。

• 最可靠的绑定方法是：在 Sublime 侧边栏，右键点击本地项目的根文件夹，然后选择 SFTP → Map to Remote…。这个操作会自动生成或关联配置文件。
• 对于高级用户，也可以手动创建 .sublime-project 项目文件，并在其中嵌入 SFTP 配置块。
• 文件上传的映射关系，依赖于本地路径与 remote_path 的对应。举个例子，如果 remote_path 是 /var/www/html/，你编辑的本地文件是 js/app.js，那么它就会被上传到 /var/www/html/js/app.js。但如果你编辑的是项目外的文件，比如 ../config.php，插件就不会触发上传。
• 另外，网络环境不佳时，默认的 3 秒超时可能太短。可以在配置里增加 "timeout": 10 来提升容错率。

上传成功但网页 500？别怪插件，看权限和 SELinux

需要警惕的是，SFTP 插件只负责“搬运工”的工作——把文件字节传过去。至于文件上传后，网站能否正常运行（比如 PHP 报 500 错误、CSS/JS 加载不了），这完全是 Web 服务器环境的问题，与插件本身无关。绝大多数情况，都是文件权限或系统安全策略（如 SELinux）在作祟。

• 插件默认上传的文件权限是 644，目录权限是 755。但对于某些特定环境（例如 suPHP、或者配置了 open_basedir 限制），可能需要文件所有者匹配，或者更严格的权限设置。
• 你可以在配置文件中尝试添加 "file_permissions": "644" 和 "dir_permissions": "755" 来明确指定权限，但这前提是服务器接受这样的设置。
• 一个更稳妥的做法是：上传文件后，立刻执行一条远程命令来修正权限。按下 Ctrl+Shift+P，输入 SFTP: Execute Command，然后输入类似 chmod 644 index.php 的命令。
• 如果上传时总提示 Failed to write file，但状态又显示 Success，这种矛盾现象很可能是被 SELinux 拦截了。登录服务器，执行命令 ausearch -m a vc -ts recent 查看安全日志，就能找到蛛丝马迹。

说到底，配置能否真正跑通，关键不在于 JSON 文件写得多么漂亮，而在于底层条件是否满足：SSH 连接是否畅通、远程路径是否可写、以及文件权限是否被操作系统层面的安全策略卡住。这些问题，恰恰是插件最“沉默”的地方，一出问题，它可能连个像样的错误提示都不会给你。