webstorm通过deployment功能上传项目需正确配置sftp连接、路径映射与自动上传选项：connection中填对host/username/root path（如/var/www/html），mappings中deployment path须以/开头且相对于root path，options中启用on explicit save action方可保存即上传。
WebStorm 上传项目到远程服务器（FTP/SFTP）怎么配
直接用内置 Deployment 功能，不依赖插件、不碰命令行。关键不是“能不能传”，而是路径映射对不对、连接模式选没选对。
常见错误现象：Test connection 成功但上传后文件找不到；Compare with Deployed Version 显示空白或报 Connection refused；右键菜单里没有 Upload to … 选项。
- 入口必须走
Settings → Build, Execution, Deployment → Deployment，别在Tools → Deployment里点错位置 - 新建服务器时选对类型：
FTP或SFTP（不是Local or mounted folder，后者只适合本地测试） -
Root path必须填服务端真实路径，比如/var/www/html，不能只填/；如果连不上，先勾选Passive mode -
Mappings标签页里：Local path是你项目根目录（自动带入），Deployment path是相对于Root path的子路径，比如填myapp，最终上传目标就是/var/www/html/myapp -
Web server root URL要填可访问的域名或 IP，比如http://192.168.1.100，否则Browse Remote Host打开后看不到预览链接
WebStorm 同步配置到另一台电脑，Settings Sync 为什么没反应
不是功能坏了，是触发条件没满足——它不轮询、不自动拉、不覆盖冲突，只在你明确操作时才动。
常见错误现象：登录 JetBrains 账户后，另一台设备重启 WebStorm，快捷键/字体/主题全没变；点了 Download settings on startup 却没生效；导出 ZIP 后导入，部分设置（如插件列表）没出现。
- 确认 WebStorm 版本 ≥
2022.3（Help → About查），旧版本即使装插件也同步不了关键项 - 登录入口在
Settings → Settings Sync右上角，不是账户头像菜单里；必须用jetbrains.com账号，GitHub 登录只是注册入口 - 首次开启后必须手动点
Upload settings to cloud，否则云端是空的；另一台设备要主动点Pull Settings from Account，不会静默拉取 - 不同步绝对路径类配置（如
External Tools里的node路径）、项目级配置（.idea/workspace.xml）、SDK 和部分插件私有数据 - 冲突时静默覆盖：A 机改了颜色主题并上传，B 机下次启动时直接被覆盖，不会提醒、不备份、不比时间戳
Gitee 仓库推送失败，提示 Authentication failed 怎么办
不是密码错了，是认证方式或插件状态不对。WebStorm 2023.3+ 内置 Gitee 支持，但必须走 OAuth 流程，且插件得启用。
常见错误现象：点 Git → Push 弹窗卡住；Version Control → Gitee 页面显示 “No accounts configured”；提交后报 remote: Invalid username or password，但网页端能正常登录。
- 确认已安装官方
Gitee插件（Settings → Plugins → Marketplace搜索安装），且重启过 IDE - 绑定账户必须走
Settings → Version Control → Gitee → Add account，选Log in via Gitee，不要手动填 token 或密码 - 企业私有 Gitee 需在
Server URL填内部地址（如https://gitee.example.com），默认https://gitee.com会连公网 - 若用 SSH 方式推送，确保
Settings → Version Control → Git → SSH Config Path指向正确的私钥，且密钥已加到 Gitee 的 SSH Keys 列表里 - 推送前检查项目是否已关联远程：右键项目根目录 →
Git → Remotes → Show All，确认 remote 地址是git@gitee.com:xxx/xxx.git或https://gitee.com/xxx/xxx.git
上传后文件没更新，本地改了但远程还是旧版
不是上传失败，是没触发同步动作——WebStorm 默认不自动上传，所有变更都得手动推或设为自动上传模式。
常见错误现象：编辑完保存，刷新浏览器还是旧页面；右键文件选 Upload to … 提示 “Up to date”，但实际内容已改；Sync with Deployed to … 之后文件名仍为蓝色（表示未提交）。
- 默认只上传“显式操作”的文件：保存后不会自动上传，必须右键 →
Upload to …或用快捷键Ctrl+Shift+Alt+U（Windows/Linux） - 想自动上传，进
Settings → Build, Execution, Deployment → Deployment → Options，勾选Upload external changes和Upload changed files automatically，但慎用——频繁小改会拖慢编辑体验 -
Sync with Deployed to …是双向同步：它会先比较差异，再把本地新内容上传、远程新内容下载，但不会覆盖本地未提交的修改 - 如果文件名是蓝色，说明 Git 已检测到修改，但 Deployment 不管 Git 状态——你得自己决定是
Commit还是Upload，两者互不触发 - 上传后记得在
Remote Host工具窗口里右键文件 →Refresh，否则界面缓存可能显示旧时间戳
