Sublime本身不支持远程编辑，必须依赖SFTP插件且严格绑定项目：需通过Project→Add Folder to Project加载目录、右键文件夹图标→Map to Remote生成sftp-config.json（名、位置、字段全须精准），upload_on_save=true仅对映射路径内文件生效。
Sublime 本身不能直接远程编辑 Linux 文件，所谓“一键连接”全是错觉——必须靠插件桥接，且每种方案的启动条件、失败路径和响应延迟完全不同。
为什么右键没 SFTP 菜单？项目没绑对就白装
插件只在「已加载的项目」中激活右键菜单，不是打开文件夹就行，也不是点空白处或单个文件能触发。
- 必须通过
Project → Add Folder to Project把本地目录加进项目，让它出现在侧边栏顶层 - 右键对象只能是侧边栏里那个文件夹图标本身，不是里面某个
.conf文件 - 安装完
SFTP（作者必须是wbond）后，务必重启 Sublime Text，否则Project菜单里都看不到 SFTP 项 - 别选错插件：
sftp-client、FTPSync等仿品不支持Map to Remote和完整配置逻辑
sftp-config.json 放哪、写啥、为啥静默失败
这个文件不是全局配置，而是严格绑定到你右键的那个文件夹根目录下，名字、大小写、扩展名一个都不能错。
- 文件名必须是
sftp-config.json（不能是SFTP-config.json、sftp_config.json或sftp-settings.json） -
remote_path必须以/开头，结尾也建议加/（如"/etc/nginx/"），否则路径拼接会偏移 - 密钥登录时，
password字段必须彻底删除，留空字符串（"password": ""）会导致插件仍走密码认证并失败 - Windows 下
ssh_key_file要用绝对路径："C:/Users/xxx/.ssh/id_rsa"或双反斜杠："C:\Users\xxx\.ssh\id_rsa"；~展开只在 Linux/macOS 有效
rsub 连不上？SSH 端口转发配错了
rsub 不是直连协议，它依赖 SSH 端口转发把远程的 127.0.0.1:52698 映射到本地同端口——没这层转发，Sublime 根本发不出请求。
- 远程执行
rsub前，先确认ruby --version ≥ 2.3；用gem install rsub --user-install，别sudo - 确保
~/.gem/ruby/*/bin在$PATH中（which rsub有输出才算数） - 本地连接命令必须是：
ssh -R 52698:localhost:52698 user@server（注意是-R，但语义是“把远程端口映射到我本地”，不是反向连接） - 如果服务器禁用了
GatewayPorts，改/etc/ssh/sshd_config并重启sshd，-o GatewayPorts=yes无效 - Windows 用户基本没法用
rsub——Sublime 找不到rsub命令，WSL2 + X11 也不稳定，不如换 SFTP
“毫秒级同步”是假象，真要低延迟得换底层机制
SFTP 插件本质是保存后触发单向上传，有网络延迟、SSH 握手开销和文件校验，实际耗时通常在 200ms–2s 之间；upload_on_save 仅对路径匹配的已映射文件生效，非映射文件改了也不会传。
- 所谓“实时同步”只是心理预期——它不监听远程文件变化，
sync_down_on_open仅在打开时拉一次，不会持续 watch - 真要毫秒响应，得用
SSHFS（FUSE 挂载）或VS Code Remote（基于 VS Code Server 的双向通道） - 运维改配置文件时，别依赖自动同步：先
Download Folder拉全量，改完再Upload Folder推，避免覆盖线上运行中的临时修改 - 多个环境（dev/staging/prod）建议用不同
sftp-config.json文件 +name字段区分，别混在一个配置里硬编码
真正卡住人的从来不是怎么配，而是哪一步没触发、哪条路径没对齐、哪个字段多了一个空格——SFTP 插件不报错，只静默跳过；rsub 不连上，只卡在 “Connecting…”。调试时先看 Sublime 底部状态栏提示，再查插件日志（Ctrl+Shift+P → SFTP: Toggle Log），比反复重装快得多。
