deployment 是 intellij idea ultimate 内置功能，community 版完全不可用；需通过 settings → build, execution, deployment → deployment 配置 sftp 连接与路径映射，root path 必须为绝对路径，deployment path 不可为空，且依赖 ssh 的 sftp 子系统启用及目标目录写权限。
Deploy 功能不是独立插件，而是 IntelliJ IDEA Ultimate 内置的「Deployment」功能模块——Community 版本完全不可用，这点必须先确认。
确认你有 Deployment 功能权限
如果你在 Tools 菜单里找不到 Deployment 选项，或 Settings → Build, Execution, Deployment → Deployment 根本不存在，那基本可以确定：你正在用 Community 版。Ultimate 订阅是硬性前提，没有替代方案。
-
FTP/SFTP/WebDAV Connectivity插件默认启用，但仅 Ultimate 捆绑；Community 中即使手动安装也会提示“Plugin is not compatible” - 按
Ctrl+Alt+S打开设置后，搜索Deployment，无结果 → 直接放弃本地配置这条路 - 别尝试复制
idea-plugins目录或破解插件 jar——IDE 启动时会校验许可证，失败即禁用整个功能模块
SFTP 部署服务器配置关键字段
配置入口在 Settings → Build, Execution, Deployment → Deployment → + → SFTP，填完基础连接信息后，真正影响上传行为的是以下三项：
-
Root path：必须填绝对路径（如/home/deploy/app），不能以~或.开头；IDE 不做路径展开，填错会导致所有文件传到根目录甚至拒绝连接 -
Web server URL：纯用于本地预览，比如填http://192.168.1.100:8080，后续点Browse Remote Host就跳转到这里；它和实际上传路径无关 -
Mappings → Deployment path：这是最关键的映射项，值是相对于Root path的子路径（如填./表示直接传到根目录，填webapp表示传到/home/deploy/app/webapp）
上传失败常见错误及对应动作
右键选 Upload to xxx 后卡住、报错或只传了空目录，大概率是下面几个原因：
- SSH 服务端限制了 sftp 子系统：检查远程
/etc/ssh/sshd_config是否含Subsystem sftp /usr/lib/openssh/sftp-server，缺了这行就无法建立 sftp 连接 - 权限不足：IDEA 默认用你配置的用户身份写入
Root path，但该用户对目标目录没有wr权限；建议提前执行chown -R deploy:deploy /home/deploy/app - 路径映射为空：
Mappings → Deployment path留空 ≠ 传到根目录，而是根本不会上传任何文件；必须显式填./或具体子路径 - 文件被排除：检查
Settings → Editor → File Types → Ignore files and folders，如果项目里有target/或build/被全局忽略，它们就不会参与部署
Alibaba Cloud Toolkit 是更实用的替代方案
如果你只是想把 Spring Boot 打包上传并启动，Deployment 功能反而容易绕弯子——它只负责拷文件，不处理构建、启停、日志追踪等环节。这时候直接用 Alibaba Cloud Toolkit 更省事：
- 它自带 Maven 构建触发，支持
mvn clean package后自动上传target/*.jar - 支持部署前执行命令（如
kill -9 $(lsof -t -i:8080)），避免端口占用 - 内置终端可直接
tail -f nohup.out，不用切到外部 terminal 查日志 - 配置项比原生 Deployment 少一半，且错误提示更明确（比如 “Connection refused” 会直接标红 SSH 端口）
真正麻烦的从来不是“怎么传上去”，而是“传完怎么让它跑起来、出错了怎么看”。原生 Deployment 只解决第一个字，后面全得自己补。
