根本原因是deployment未启用自动上传或文件不在映射路径内；需检查options中“upload changed files automatically”是否勾选、default server是否正确，并确认mappings中local path与deployment path（相对root path）配置准确无误。
为什么修改文件后 SFTP 没自动上传？
根本原因通常是 Deployment 配置未启用「自动上传」，或当前文件不在已映射的本地路径下。PhpStorm 不会全局监听所有项目文件——它只对在 Deployment > Configuration > Mappings 中明确设置了本地路径与远程路径映射的目录生效。
常见错误现象：File > Upload to... 能手动传，但保存即上传不触发；或者只上传了部分文件（比如漏配了 vendor/ 或 dist/）。
- 检查
Settings > Build, Execution, Deployment > Deployment > Options，确认勾选了Upload changed files automatically to the default server，且下拉选的是你配置好的服务器名 - 确保当前编辑的文件路径在
Mappings表格中至少有一行匹配（支持通配符，但推荐用具体路径，避免误配） - 如果用了多服务器配置，
Default server必须设为你要自动上传的目标项，否则自动上传逻辑直接跳过
如何正确设置 SFTP 连接和路径映射？
连接失败或上传到错目录，90% 出现在这一步。SFTP 配置本质是「谁连谁、连哪、放哪」三件事，缺一不可。
- 在
Deployment > Configuration > Connection中，SSH configuration推荐用密钥登录：填好Host、Port、User name，再点... → Key pair选私钥（不是id_rsa.pub！） -
Root path填远程服务器上该用户的绝对路径起点，比如/var/www/html；不要填~或空值，否则上传路径计算会出错 - 在
Mappings页签里，Local path必须是项目根目录下的相对路径（如.或src/），Deployment path是相对于上面Root path的路径（如/或/app），两者要能拼出完整目标地址
保存即上传但报错“Permission denied”怎么办？
这不是 PhpStorm 的问题，而是远程服务器权限或用户身份不匹配导致的。SFTP 上传用的是你配置的 SSH 用户，该用户必须对目标目录有写权限。
- 先 SSH 登录服务器，运行
ls -ld /var/www/html（替换成你的Root path），确认输出中包含drwxr-xr-x这类允许写入的标志，且属主/属组是你配置的用户名 - 如果目录属主是
www-data，而你用的是普通用户deploy，需执行sudo usermod -a -G www-data deploy并重启 sshd，或改用www-data用户配 SSH（不推荐，安全风险高） - 某些主机（如 shared hosting）禁用
chmod和chown，此时即使上传成功，文件也可能因权限不足无法执行——务必在上传后手动验证phpinfo()或访问页面是否正常
自动上传时忽略 node_modules、.git 等目录
默认情况下，PhpStorm 会上传所有改动文件，包括大体积的依赖目录，既慢又无意义。必须显式排除。
- 进入
Settings > Build, Execution, Deployment > Console > Terminal，找到Exclude console output from file watcher？不对——这是干扰项。正解在Deployment > Options下方的Excluded Paths输入框 - 在这里逐行填入要跳过的路径，支持通配符：
node_modules/**、.git/**、composer.lock、dist/**—— 注意每行一个，不能逗号分隔 - 排除仅影响自动上传，不影响手动上传（
Upload to...）和远程同步（Sync with Deployed to...），所以测试阶段建议先关掉自动上传，用手动 + 同步组合验证排除逻辑是否生效
自动上传看似一键开启，实际依赖连接稳定性、路径映射准确性、远程权限合理性三者同时成立。最容易被忽略的是 Mappings 中的 Deployment path 是相对路径，不是绝对路径——很多人填成 /var/www/html 导致最终上传到 /var/www/html/var/www/html/xxx 这种嵌套怪路径里。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
