只要 upload_on_save 设为 true 且 remote_path 权限、网络、认证正常，保存即上传可稳定工作；需通过右键项目根目录→SFTP/FTP→Map to Remote 自动生成 sftp-config.json，并确保 type 为 "sftp"、host 不带协议头、remote_path 结尾无斜杠、密码或 ssh_key_file 配置正确，同时 upload_on_save 必须为布尔值 true、文件在映射目录内、服务器路径存在且有写权限、22 端口连通、ignore_regexes 使用正确正则（如 "^.git"、".*.log$"、"sftp-config.json"）。

只要 upload_on_save 设为 true，且 remote_path 权限、网络、认证都正常，保存即上传就能稳定工作。不是“理论上可以”，而是多数项目里开箱即用——但容易卡在几个具体细节上。

如何快速生成并验证 sftp-config.json

别手动新建 JSON 文件。正确路径是：右键项目根目录 → SFTP/FTP → Map to Remote，插件会自动生成 sftp-config.json 并放在项目文件夹下（不是全局配置目录）。这样做的好处是：每个项目可独立配不同服务器，避免冲突。

生成后必须检查以下几项：

• "type" 值必须是 "sftp"（不是 "ftp"），否则走 FTP 协议，22 端口连不上
• "host" 不能带 http:// 或 https://，只填域名或 IP，比如 "example.com" 或 "192.168.1.100"
• "remote_path" 结尾不加斜杠（/var/www/html ✅，/var/www/html/ ❌），否则部分服务器会报 “No such file”
• 如果用密码登录，确认 "password" 字段已取消注释（删掉前面的 //）且值正确；用私钥则必须配 "ssh_key_file" 路径，并确保该文件可读

upload_on_save 失效的常见原因

保存后底部没出现上传进度条，或提示 “Upload failed”，先盯住这四点：

• 本地文件**不在已 Map 的项目目录内**：Sublime 只对通过 Map to Remote 关联的文件夹生效，单个文件或未加入项目的子目录不会触发上传
• "upload_on_save" 写成了字符串 "true"（带引号）——必须是布尔值 true，JSON 里不加引号
• 服务器端 remote_path 目录不存在，或用户无写权限（常见于 Linux，用 ls -ld /var/www/html 检查属主和权限）
• 防火墙或云服务商安全组拦截了 22 端口（SFTP）或 21 端口（FTP），可用 telnet your-server.com 22 快速验证连通性

忽略规则 ignore_regexes 怎么写才不误伤

这个字段控制哪些文件不上传，用的是正则表达式，不是 glob。容易出错的地方：

• 匹配文件名开头要加 ^，比如想忽略所有 .git 目录，得写 "^\.git"（注意双反斜杠转义）
• 匹配扩展名结尾要用 $，例如忽略 .log 文件：".+\.log$"
• 不要写成 "*.sublime-project" —— * 在正则里不是通配符，得用 ".*\.sublime-project"
• 常见漏配："sftp-config\.json" 必须加，否则配置文件自己会被上传到服务器，造成混乱

最常被忽略的是 remote_path 权限和 ignore_regexes 的正则写法——前者导致上传静默失败，后者让关键配置或构建产物意外被跳过。配完别急着写代码，先改一行保存，看底部状态栏有没有 Uploading... 和成功提示，再继续。