PhpStorm远程部署核心功能由内置FTP/SFTP/WebDAV插件提供，入口在File→Settings→Tools→Deployment（Windows/Linux）或PhpStorm→Preferences→Tools→Deployment（macOS），非插件开关问题，而是配置与服务连通性问题。
PhpStorm 本身不依赖插件实现远程部署，核心功能由内置的 FTP/SFTP/WebDAV 连接性 插件提供，该插件默认启用、不可卸载。所谓“设置插件”，实际是启用并正确配置内置部署模块。
Deployment 配置入口在哪
很多人卡在找不到入口——它不在 Plugins 页面，而在 File → Settings → Tools → Deployment（Windows/Linux）或 PhpStorm → Preferences → Tools → Deployment（macOS）。快捷键是 Ctrl+Alt+S，然后手动导航到 Tools → Deployment。
注意：Deployment 不是独立插件开关项，它是 IDE 底层能力，只要没被手动禁用（极罕见），就始终可用。
为什么点了 Test Connection 却一直卡在 “Testing connection…”
这不是插件问题，而是 SSH/SFTP 服务层未响应。常见原因包括：
立即学习“PHP免费学习笔记（深入）”；
- 远程服务器防火墙拦了端口 22（SFTP）或 21（FTP），
sudo ufw status或iptables -L看一眼 - SSH 服务运行但
sftp-server子系统被禁用：检查/etc/ssh/sshd_config是否有Subsystem sftp /usr/lib/openssh/sftp-server或等效行 - 用户被
ChrootDirectory限制后，Root path填了绝对路径（如/var/www），但实际 SFTP 根是/—— 此时应填/，而非映射前的路径 - 私钥格式错误：PuTTY 的
.ppk文件不能直接用，必须用 PuTTYgen 导出为 OpenSSH 格式（无密码、无后缀或.key）
自动上传不生效，或传完远程文件没更新
根本不是插件失效，而是路径映射和触发策略错配：
- 别勾选
Automatic upload to remote host on save（已弃用且不稳定），改用Upload changed files automatically to the default server -
Mappings → Deployment path on server必须与你实际访问网站的目录完全一致；比如 Nginxroot /var/www/html;，那这里就得填/html或/，而不是/var/www/html - 上传后远程时间戳不变？可能是 NFS/Docker volume 不支持
utimes()，导致 PhpStorm 认为“文件未改动”，跳过覆盖 —— 此时需手动右键 →Deployment → Upload to … - 上传失败无提示？去
View → Tool Windows → Deployment → Log翻日志，重点搜Permission denied、No such file、Connection reset
远程 PHP 解释器配置失败，报 “Failed to load interpreter information”
这和 Deployment 是两套机制，但共用 SSH 连接配置。失败通常因为：
- 远程用户执行
php -v报错（如command not found或Segmentation fault），说明 PHP 不在$PATH或环境缺失（如容器内没装php-cli） - 填了
/usr/bin/php却实际在/opt/php82/bin/php—— 必须填绝对路径，不能依赖环境变量 - 用了 Docker 类型却选了 SSH Configuration，结果 PhpStorm 尝试从宿主机 SSH 执行一个只在容器里存在的路径
- 远程 PHP 编译时禁用了
--enable-opcache或--with-readline，导致某些内部检测命令失败，不影响使用，但会中断初始化流程
最易被忽略的一点：远程解释器配置成功后，PHP → Include Paths 和扩展 stubs（如 redis、pdo_mysql）仍需手动勾选，否则代码补全和类型推导照样失效。
