根本原因在ssh底层链路：connection refused是服务未启/防火墙拦截/端口错，permission denied是私钥格式不符（需pem）、公钥未部署或用户shell非法；须先终端验证ssh -i key user@host再配phpstorm。
能直接编辑，但不是“打开文件就自动同步”，必须配对 Deployment + Remote Host 视图 +（可选）Remote Interpreter 才算真正可用。
Connection refused 或 Permission denied (publickey) 怎么快速定位
根本不是 PhpStorm 的问题，是 SSH 连接链路断在了底层。别急着改 PhpStorm 设置：
- 先在终端执行
ssh -i /path/to/private_key user@host—— 能通，PhpStorm 才可能通；不通就别往下配 -
Connection refused：服务端没开 SSH（systemctl status sshd）、防火墙拦了端口（ufw status或firewall-cmd --list-ports）、或端口填错（比如填了 80） -
Permission denied (publickey)：私钥格式不对（老版本 PhpStorm 只认 PEM 格式，OpenSSH 默认生成的-----BEGIN OPENSSH PRIVATE KEY-----会失败；用ssh-keygen -p -m PEM -f id_rsa转）、公钥没正确追加到服务器~/.ssh/authorized_keys、或用户 shell 被设为/bin/false（SFTP 需要合法 shell）
Deployment → SFTP 配置里三个必填死点
填错任意一个，连接能测通，但文件上传/浏览会静默失败：
-
Host填 IP 或域名，**不要带ssh://前缀**（否则 Test Connection 直接报错） -
Auth type选Key pair后，Private key file必须指向本地 PEM 格式私钥（路径不能有中文、空格；Windows 下注意反斜杠转义或用正斜杠） -
Root path必须是**绝对路径**，如/var/www/html；填~或留空会导致 Remote Host 视图打不开目录，或上传后文件位置错乱
Remote Host 视图能打开，但改完保存不上传？
Remote Host 是只读浏览入口，它本身不触发上传。真要边改边同步，得靠两套机制配合：
- 手动上传：右键文件 →
Upload to [server]，或快捷键Ctrl+Shift+Alt+Up（Windows/Linux）/Cmd+Shift+Option+Up（macOS） - 自动上传：进
Tools → Deployment → Options，勾选Upload changed files automatically to the default server，并选On explicit save action（别选On file change，改个字母就传一次，vendor 目录下卡死） - 注意：
Excluded paths（比如.env,storage/logs）只影响自动上传监听范围，不影响手动 Upload —— 所以 .env 改了仍可能被手误传上去
为什么 Remote Host 里文件名变灰、双击打不开
这不是权限问题，是 PhpStorm 没把远程路径映射成“项目根”。它只当你是临时浏览，不加载语言服务：
- 想获得完整 PHP 支持（跳转、补全、错误检查），必须在
File → Open时选择Remote Development → SSH，然后输入服务器信息，选中远程目录作为项目根启动 - 或者，在已有本地项目里，用
File → Settings → Directories把本地目录标记为Sources，再通过 Deployment 的Mappings将其映射到远程路径（Local path和Deployment path要严格对应） - 如果用了符号链接（如
public/storage → ../storage/app/public），SFTP 协议不解析软链目标，Remote Host 会显示为空或报错；要么在服务器端用物理路径，要么改用 rsync 同步替代
最常被忽略的是：Remote Host 视图和真正的远程开发项目是两套逻辑。前者适合查日志、看配置；后者才能调试、运行、享受 IDE 全功能——别指望点开 Remote Host 就能 F5 调试。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
