sublime text 需通过 sftp-next 插件映射远程服务器目录才能同步配置文件;必须将本地空文件夹添加为顶层项目、生成严格命名和格式的 sftp-config.json,并满足路径、认证、上下文等四类隐性条件,upload_on_save 方可生效。

Sublime Text 本身不能直接编辑远程数据库配置文件,必须通过 SFTP 插件建立与服务器的文件级同步;它不执行 SQL 或连接数据库,只负责把本地修改后的文本文件(如 config.php、database.yml、.env)上传到远程路径。关键不是“连上数据库”,而是“连上放配置文件的那台服务器”。
右键没 SFTP 菜单?项目没被识别为可映射目录
这不是插件没装好,是 Sublime 根本没把你当前操作的对象当成一个“可配 SFTP 的上下文”。
- 必须用 Project → Add Folder to Project 把本地空文件夹加进项目,且该文件夹要出现在侧边栏最顶层(不能是子目录)
- 右键菜单只在这个顶层文件夹图标上才出现
Map to Remote…,点里面某个.env文件或侧边栏空白处都不行 - Sublime Text 4(Build 41xx+)必须装
SFTP-Next,原版SFTP会报ImportError: No module named 'urllib3' - 装完插件后必须重启 Sublime,否则
Project菜单里压根看不到 SFTP 相关项
sftp-config.json 必须满足这四条硬规则
这个文件不是手动创建的全局配置,而是插件仅读取“右键 → Map to Remote…”后自动生成在项目根目录下的唯一凭证,任何偏差都会导致 upload_on_save 失效。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 文件名严格为
sftp-config.json(大小写敏感,不能是SFTP-config.json或sftp_config.json) -
remote_path必须以/开头,结尾也建议加/(例如"/etc/mysql/conf.d/"),否则路径拼接会偏移 -
ssh_key_file支持~展开(如"~/.ssh/id_rsa"),但不识别$HOME或其他环境变量 - 不能同时写
password和ssh_key_file—— SSH 层直接拒绝,错误只显示Authentication failed,无具体提示
upload_on_save 不生效?检查这四个隐性条件
开关开着 ≠ 自动上传。它依赖一组静默上下文,缺一不可。
-
upload_on_save必须放在配置文件根层级,不能嵌套在files或sync_down_on_open下面 - 当前编辑的文件必须属于已保存的项目(即存在
.sublime-project文件),且其本地路径需能被remote_path规则覆盖(比如配了"/etc/nginx/conf.d/",但你在/src/nginx.conf编辑,就不会上传) - 网络抖动或服务器响应慢时,默认 3 秒超时会导致静默失败;可在配置中加
"timeout": 10提高容错 - 首次连接会弹出主机指纹确认框,必须手动点
Yes,否则后续所有操作都卡在认证环节
最常被忽略的是:remote_path 写成 "etc/nginx/conf.d"(缺开头斜杠)或 "./etc/nginx/conf.d/"(带点),这种路径在 SFTP 插件里会被解释成相对路径,结果上传到用户家目录下某个奇怪子目录,而不是你真正想改的系统配置位置。










