WebStorm 的 Deployment 功能能实现代码同步，但「自动上传 ≠ 安全同步」——它只单向推本地变更，不拉取远程改动，也不校验文件一致性。开错选项或填错路径，轻则 404，重则覆盖系统文件。
Connection 里 Host/User name/Root path 填错就白配
这三个字段是连接成败和部署可见性的核心，WebStorm 不会明确报错，但会导致 Test Connection 失败，或上传后访问 404：
Host 必须是服务器可直连的 IP 或域名（比如 192.168.2.100 或 prod.example.com），不能写 localhost 或内网地址（如 10.0.0.x）User name 是 SSH 登录用户名（如 root、ubuntu、deploy），不是云控制台账号名Root path 是服务器上项目实际运行的绝对路径（如 /var/www/html、/opt/tomcat/webapps/myapp），填错会导致文件传到错误位置，Nginx/Apache 找不到资源端口默认是 22，改过 SSH 端口的必须手动填；密钥认证时，Key pair 必须指向私钥文件（如 ~/.ssh/id_rsa），不是 .pub 文件配置前建议先在终端执行 ssh user@host -p port 验证连通性，这是最可靠的前置检查
Mappings 中 Local path 和 Deployment path 的路径规则
这两个字段定义「本地哪→服务器哪」，不是映射关系，而是源-目标搬运路径，斜杠方向和相对性极易出错：
Local path 通常选项目根目录（如 /Users/me/project），也可精确到 dist 目录（如 /Users/me/project/dist）Deployment path 是相对于 Root path 的路径，**必须以 / 开头**（如 Root path 是 /var/www，那 Deployment path 应填 /my-app，而不是 my-app）如果项目需部署为子路径（如 https://example.com/admin），Deployment path 必须与 Web server URL 末尾一致（即填 /admin）多模块部署（如前端 + API）可用 Add another mapping 单独配：本地 src/api → 远程 /api不想传 node_modules 或 .git？切到 Excluded paths 标签，加 /node_modules、/.git（注意是正斜杠，Windows 也一样）
Upload changed files 自动上传模式怎么选
自动上传有三个选项，行为差异直接影响开发稳定性：
Never：纯手动，右键选 Upload to… 才触发，适合只在发布前批量推送Always：只要文件内容变更（哪怕还没保存），就立刻上传——会把编辑中未保存的草稿、临时文件（如正在重命名的 index.js~）也推上去，风险高On explicit save action（推荐）：仅当你按下 Ctrl+S（macOS 是 Cmd+S）时上传，可控性强，避免半截代码上线⚠️ 注意：无论选哪个，WebStorm 都不会自动下载远程变更。多人共用测试机时，若别人改了配置又没提交 Git，你开自动上传可能直接覆盖掉
首次部署和日常维护的几个关键动作
配置完不等于能用，这几个操作常被跳过，却决定是否真正跑起来：
首次使用前，务必右键项目根目录 → Deployment → Upload to… 手动上传一次完整目录，确保服务器有基础结构上传后访问 404？先确认 Nginx/Apache 是否已重启，再检查 Root path 和 Deployment path 拼出来的最终路径是否真有文件（可用 Tools → Deployment → Browse Remote Host 查看）想验证文件一致性？在 Remote Host 工具窗口中右键文件 → Compare with Local，比对内容差异误传错文件？右键远程文件 → Download from… 拉回来，或直接删掉重传长期运行的 Node.js 服务关终端就停？别依赖 WebStorm 启动，用 screen -S myapp 或 pm2 start 守护进程
路径开头的斜杠、Root path 与真实运行路径的一致性、以及「上传不等于同步」这个前提，是绝大多数同步失败的根本原因。配置时盯着这三点，比反复点 Test Connection 更有效。
评论(0)