remote-edit 连不上需确认 SSH 密钥认证是否配置正确，权限为600，地址格式为user@host:port；保存失败需查开发者工具；大文件超时可调高timeout值；不支持断线重连，网络异常后需手动重启文件标签。
remote-edit 装了连不上？先确认 SSH 认证方式是否匹配
remote-edit 本质是走 SSH 协议拉取文件，但它不支持交互式密码输入——只认密钥认证。如果你配的是密码登录，插件会静默失败，Atom 状态栏可能只显示“Connecting…”然后消失，没报错也没提示。
- 确保远程服务器的
~/.ssh/authorized_keys已写入你的私钥对应公钥 - 本地私钥权限必须是
600（chmod 600 ~/.ssh/id_rsa），否则 SSH 拒绝加载 - 在 Atom 设置里填 SSH 地址时，格式要严格为
user@host:port，比如alice@192.168.1.100:2222；端口不写默认是 22，但显式写出更稳妥 - 别用 root 用户直连——很多发行版默认禁用 root SSH 登录，建议用普通用户 +
sudo权限配合后续操作
编辑保存后远程文件没更新？检查同步机制是否被绕过
remote-edit 是「按需拉取+本地编辑+保存即上传」的单向同步模型，它不会监听远程文件变更，也不做后台 diff。你改完点 Ctrl+S，它才通过 scp 把当前文件推回去——这意味着：
- 如果远程文件被其他人或脚本同时修改，你本地保存会直接覆盖，无冲突提醒
- 保存失败时 Atom 不弹错误框，只在开发者工具控制台抛
Failed to upload file，得手动开View → Developer → Toggle Developer Tools查看 - 大文件（>5MB）上传容易超时，可在 Atom 配置中调高
remote-edit.timeout值（单位毫秒，默认 10000）
想边写边跑代码？Terminal 和 Hydrogen 得分开配
remote-edit 只管文件，不提供执行环境。想在远程服务器上运行 Python 或 Bash，得另外搭路子：
- 用
platformio-ide-terminal插件：安装后新建终端，默认就是本地 shell；要连远程，得手动执行ssh user@host，属于“终端里套终端”，不推荐长期使用 - 真远程执行推荐
Hydrogen+ 远程 Jupyter 内核：先在服务器跑jupyter lab --ip=0.0.0.0 --port=8888 --no-browser --allow-root，再把生成的kernel.json中的ip、port、key填进 Hydrogen 的 Gateway 设置里 - 注意：Hydrogen 的远程内核不走 SSH 隧道，所以服务器的
8888端口得能被 Atom 所在机器访问（防火墙、云平台安全组都要放行）
.ftpconfig 和 remote-edit 能共存吗？别混用
remote-edit 和 remote-ftp 是两套完全独立的协议栈：前者基于 SSH/SFTP，后者基于 FTP/SFTP（但实现不同）。它们的配置文件互不识别，强行共存会导致行为混乱——比如用 remote-ftp 连着，又点 remote-edit 的菜单，结果连到不同服务器。
- remote-edit 的配置全在 Atom Settings → Packages → remote-edit → Settings 里填，不读任何外部文件
- remote-ftp 必须靠项目根目录下的
.ftpconfig，且该文件必须是合法 JSON，字段名不能错（比如是host不是hostname） - 一个项目只选一种：SSH 环境优先 remote-edit；老系统只开 FTP 就只能用 remote-ftp
最常被忽略的一点：remote-edit 没有断线重连机制。网络抖动或服务器休眠唤醒后，已打开的远程文件标签页会变成只读状态，但界面毫无提示——你得手动关掉再重新从远程树里打开。
