Remote-FTP插件在2026年已彻底失效,因其自2021年起停止维护,底层ftp模块与Atom 1.60+及新版系统(macOS Sonoma、Windows 11、Ubuntu 22.04+)的Node.js/Electron严重冲突,启动即报Cannot find module 'ftp',属硬性依赖崩溃,非配置问题。

Remote-FTP 插件在 2026 年已不可用,不是配置问题,而是底层依赖崩溃导致的硬性失效。 它自 2021 年起停止维护,与 Atom 1.60+ 及当前系统(macOS Sonoma、Windows 11、Ubuntu 22.04+)的 Node.js/Electron 版本严重冲突,启动即报 Cannot find module 'ftp' —— 手动安装或降级 Atom 都无法稳定运行,且会引发 SSL 失败、中文路径乱码、PASV 超时等新问题。
Remote-FTP 启动就报 Cannot find module 'ftp' 怎么办
这不是你漏装依赖,是插件作者早已放弃维护,其依赖的 ftp 模块与新版 Electron 内置的 Node.js 不兼容。社区 GitHub issues 最后有效回复停留在 2022 年,无人修复。
- 降级 Atom 到 1.58 以下会触发新错误:SSL 连接失败、
ENOTCONN监听异常、中文路径解析为空 - 手动
npm install ftp或 patchnode_modules会破坏 Atom 安全沙箱,且每次更新自动清空 - 所有“重装插件”“清缓存”“重配 config”操作都无效——问题不在配置层,而在模块加载阶段
为什么连得上但侧边栏空白、remote 目录不显示文件
常见原因不是网络不通,而是协议错配或权限卡死。插件静默失败,不报错也不提示。
-
"protocol": "sftp"却填了"port": 21,或反过来填"protocol": "ftp"+"port": 22—— SFTP 和 FTP 是两套完全不兼容的协议栈 -
"remote"必须是绝对路径,如"/home/deploy/app";写成"app"或"./app"就列不出任何内容 - 用户对远程目录只有
r-x(执行权),缺r--(读权),ls命令直接失败,但插件不提示 - 打开
View → Developer → Toggle Developer Tools,在 Console 中搜索remote-ftp,才能看到真实错误,例如Permission denied (publickey)
remote-edit 连不上 SSH?它只认密钥,且对格式和权限极其敏感
remote-edit 是目前唯一还能跑的替代方案,但它走的是 SFTP 协议(基于 SSH),完全不支持密码登录——输错密码或没配密钥,只会卡在 Connecting… 然后消失,控制台也无报错。
- SSH 地址格式必须完整:
user@host:port,例如deploy@10.0.2.15:2222;省略端口默认走 22,但很多 VPS 改过端口,漏写就永远连不上 - 本地私钥文件(如
~/.ssh/id_rsa)权限必须是600:chmod 600 ~/.ssh/id_rsa,否则 Node.js 的 SSH 库直接拒绝加载 - 远程
~/.ssh/authorized_keys必须已写入你本地公钥,用ssh-copy-id deploy@10.0.2.15 -p 2222最稳,别手抄 - 保存失败时,打开 Developer Tools,在 Console 中搜
Failed to upload file才能看到具体错误(比如permission denied或timeout)
真正能用的替代方案只有 sshfs 挂载
因为它是操作系统级挂载,Atom 完全感知不到“远程”存在,所有功能照常运行——但前提是避开 Atom 自身的监听器缺陷。
- macOS:
brew install sshfs,再运行sshfs user@host:/path ~/mnt/remote -o follow_symlinks - Windows:装
WinFsp+SSHFS-Win,右键“Map network drive”,填sftp://user@host/path - Linux:确保用户在
fuse组,mkdir -p ~/mnt/remote后执行sshfs user@host:/path ~/mnt/remote - 挂载后在 Atom 中用
File → Add Project Folder打开~/mnt/remote,编辑保存就是实时同步,不用点上传、不卡顿、不丢文件
真正麻烦的从来不是连上,而是密钥权限、超时阈值、挂载点 fuse 权限这些零散但致命的细节。漏一个,整个流程就卡在 Connecting… 不动。

















