intellij idea的deployment功能本质是带路径映射的sftp同步器，非一键部署工具；root path为远程绝对部署起点，local path须精准指向待上传项目子目录，web server url仅用于前端预览，不参与传输逻辑。
IntelliJ IDEA 自带的 Deployment 功能不是“一键部署”工具，它本质是带路径映射的 SFTP 同步器；用错场景或忽略配置细节，上传后服务起不来、文件错位、权限丢失都是大概率事件。
Deployment 配置里最常填错的三项参数
很多人卡在“连接成功但上传失败”或“文件传上去了却找不到”，问题往往出在三个基础字段的语义理解偏差：
-
Root path on target host：不是你ssh登录后的默认家目录，而是你要部署到的**绝对路径起点**（例如/opt/myapp），IDEA 会把本地映射路径下的所有内容相对地塞进去 -
Local path：必须指向你项目中**实际要上传的根目录**（比如target/myapp-1.0.jar所在的target/，或整个src/main/resources），不能选错层级，否则上传空目录或漏文件 -
Web server root URL：纯用于前端资源预览，和后端部署无关；填了也不会影响 SFTP 行为，但若误填成http://localhost:8080并勾选 “Upload external changes automatically”，可能触发无意义的重传
上传后 Java 服务起不来？检查这三件事
Deployment 只管传文件，不负责启动、不改权限、不读 application.yml，常见失败点集中在运行环境衔接上：
- 传上去的
.jar文件没有执行权限：SFTP 默认不保留本地 chmod，需手动在远程执行chmod +x myapp.jar，或在 Deployment 的 “Options” 页勾选 “Preserve file permissions”（仅限支持该协议的服务器） - 没传依赖或配置文件：
mvn package生成的单 jar 默认不含lib/和外部config/，得确认你上传的是target/myapp-1.0.jar还是整个target/目录，后者才可能包含application-prod.yml - 启动命令写在本地，没同步到远程：Deployment 不会帮你执行
nohup java -jar ... &，必须另开 Terminal 连 SSH 手动运行，或配合 Alibaba Cloud Toolkit 等插件补足这步
什么时候该换用 Docker 或 Alibaba Cloud Toolkit
Deployment 适合静态资源同步、小工具脚本分发、或已有成熟运维流程的团队做“半自动搬运”。一旦出现以下任一情况，就该切换方案：
- 需要构建 → 推镜像 → 拉取 → 启动全链路自动化：
Docker插件可直连本地dockerd，定义Dockerfile后一键 build & push - 部署目标是阿里云 ECS，且希望跳过手动填 IP/密码：
Alibaba Cloud Toolkit支持 RAM 子账号密钥、自动识别pom.xml构建参数、内置tail -f nohup.out日志流 - 多个环境（dev/staging/prod）配置差异大：Deployment 的每个 Server 都要单独配映射，而
docker-compose.yml或 Toolkit 的 Host Profile 可复用模板+变量注入
Deployment 的核心价值是轻量、无侵入、不依赖额外服务；但它不解决环境一致性、进程管理、配置中心对接这些事。别指望它替代 systemd、consul 或 CI 流水线 —— 它只是你右键菜单里的一个“上传按钮”，按对了位置才有用。
