IDEA远程开发必须用Remote Development模式（非SFTP），需确认：启用插件、远程安装jetbrains-agent、SSH监听0.0.0.0、开放22和1080端口；认证优先选OpenSSH密钥；路径映射须严格一致；勿混用Remote JVM Debug。
IDEA 配置 SSH 远程开发环境，核心不是“连上就行”，而是让本地编辑、远程构建、调试、文件同步全部闭环且稳定。关键判断：必须用 Remote Development 模式（JetBrains Gateway 后端），而不是旧版的 SFTP 部署 + 手动上传——后者本质仍是本地开发，仅同步文件，无法真正复用远程 JDK、Maven、Shell 环境和进程上下文。
Remote Development 模式启动前必须确认的 4 件事
这是最容易卡住的环节，缺一不可：
-
Remote Development插件已启用：IDEA 2023.2+ 默认内置，但若被手动禁用，需进Settings → Plugins搜索并启用Remote Development；Ultimate 版才支持，Community 版无此功能 - 远程服务器已安装
jetbrains-agent：IDEA 不会自动安装它。需在远程 Linux 上运行命令下载并解压（官方脚本会自动检测系统架构）：curl -fsSL https://download.jetbrains.com/idea/jetbrains-agent-remote-dev.tar.gz | tar -xzf - -C ~
解压后路径应为~/jetbrains-agent - SSH 服务监听地址非
127.0.0.1：检查/etc/ssh/sshd_config中ListenAddress是否包含0.0.0.0或具体外网 IP；若只有127.0.0.1，Gateway 将无法从本地建立反向连接 - 防火墙放行 22 端口（SSH）及
jetbrains-agent默认端口（1080）：云服务器还需额外在安全组中开放这两个端口
配置 SSH 连接时认证方式选哪个？
优先选 Key pair (OpenSSH)，不是密码。原因很实际：
- 密码登录在 Remote Development 启动过程中会被反复调用（如拉取 agent、建立隧道、启动后台服务），输错一次就会中断流程，且 IDEA 不缓存密码用于后续自动操作
- 私钥必须是 OpenSSH 格式（
-----BEGIN OPENSSH PRIVATE KEY-----开头），PuTTY 的.ppk不兼容；若你只有.ppk，用 PuTTYgen 转成 OpenSSH 格式再保存 - 私钥带密码短语（passphrase）没问题，但务必勾选
Save passphrase—— 否则每次启动 Remote Development 都弹窗，无法后台静默运行 - 不要选
OpenSSH configuration and authentication agent：它依赖本地ssh-agent或 Pageant，而 Remote Development 启动阶段不继承你的 shell 环境变量，大概率找不到 agent socket
路径映射（Mappings）不是“同步代码”，而是定义工作区根目录
这里常被误解为“类似 rsync 的同步设置”，其实它是告诉 IDEA：“远程服务器上的哪个目录，等同于我本地项目打开的根路径”。影响的是所有路径解析行为，比如：
- Maven 构建时读取的
pom.xml、settings.xml路径 - Run/Debug 配置中指定的 Working directory
- Terminal 中默认打开的起始目录
- 甚至 Git 提交时识别的仓库根位置
所以必须严格一致：Local path 填你本地 IDE 打开的项目文件夹（如 C:\dev\my-spring-boot），Deployment path 填远程服务器上对应绝对路径（如 /home/user/code/my-spring-boot）。如果填错，你会看到 Maven 报 Project not found、Git 显示 “unregistered root” 等问题。
Remote JVM Debug 和 Remote Development 是两套体系，别混用
很多人想“先配好 Remote JVM Debug，再加 Remote Development”，结果失败。因为：
-
Remote JVM Debug是调试器连接一个已运行的 JVM 进程，它不关心代码在哪编译、JDK 版本是否匹配、Maven 依赖是否就位——它只连端口 -
Remote Development是把整个开发栈（IDE 后端、JDK、Maven、Shell、Git）都搬到远程，本地只是图形客户端。它要求远程环境完整可执行，包括java -version、mvn -v必须能正常输出 - 如果你已在远程跑着一个带
-agentlib:jdwp的 Spring Boot，又启用了 Remote Development，IDEA 会尝试用自己的 JDK 启动新进程，导致端口冲突或类加载混乱
真正需要远程调试时，直接在 Remote Development 环境里新建 Spring Boot Run Configuration，IDEA 会自动用远程 JDK 启动，并内建调试支持——这才是正向流程。手动加 JDWP 参数反而绕远路。
最易被忽略的点：Remote Development 启动后，所有终端、Maven、Gradle、Git 操作都发生在远程服务器上，本地 Terminal 窗口只是个输入转发器。这意味着你不能在本地改完 application.yml 就以为生效了——必须确保文件已通过 Remote Development 的自动同步机制落盘到远程路径，否则远程进程读到的还是旧配置。
