SSH连接失败主因是PhpStorm未正确加载私钥，需新建SSH配置并指定密钥路径；远程解释器需单独配置composer/Xdebug路径；Xdebug 3.x禁用remote_参数；SFTP上传依赖显式保存或自动上传设置。
SSH连接失败：Authentication failed但密码/密钥明明正确
根本不是账号密码错，而是 PhpStorm 启动的 SSH 进程压根没读到你的私钥——尤其当你用的是带密码的密钥、或密钥不在 ~/.ssh/id_rsa 默认路径时。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
Settings > PHP > CLI Interpreter > Add > SSH Configuration里，必须点 “+” 新建配置，不能双击已有项编辑，否则密钥路径常被忽略 - Auth type 选
Key pair，然后手动指定私钥完整路径（如/home/user/.ssh/my_deploy_key） - 如果私钥有密码，PhpStorm 只弹一次输入框；输错后不会重试，直接报
Authentication failed，得删掉整个配置重来 - Linux/macOS 下务必执行
chmod 600 /path/to/private_key，SSH 协议强制拒绝权限宽松的密钥文件
远程解释器配好了，但 Composer 命令不识别、Xdebug 断点不触发
因为 PhpStorm 默认只同步 PHP 可执行文件路径（如 /usr/bin/php），不会自动把 composer、phpunit、xdebug.so 这些也拉过去——它们得各自单独配，且路径必须是远程服务器上的绝对路径。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
Settings > PHP > CLI Interpreter页面，点击右下角Show all local paths，手动映射：本地项目根目录 → 远程部署路径（如/var/www/myapp），否则 Xdebug 找不到源码位置 - Xdebug 必须在远程
php.ini中启用：zend_extension=xdebug.so，且至少包含xdebug.mode=debug和xdebug.start_with_request=trigger - 远程
composer路径要单独填：Settings > PHP > Composer > Path to composer.phar改成远程绝对路径，例如/usr/local/bin/composer，别留空或填本地路径 - 如果远程 PHP 是用
phpbrew或asdf管理的，必须填完整路径，比如/home/user/.phpbrew/php/php-8.2.12/bin/php，shell alias 无效
Xdebug 断点静默失效：端口监听、路径映射、版本三者缺一不可
断点不触发，90% 是因为 Xdebug 3.x 配置混用了旧参数（xdebug.remote_*），或者 IDE 监听端口没开、路径映射错位。Xdebug 3.x 已废弃全部 remote_ 前缀参数，混用会导致 xdebug_info() 显示已加载但调试静默失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 删掉
php.ini里所有含remote_的行（如xdebug.remote_host、xdebug.remote_port） - 只保留基础三行（直连场景）：
xdebug.mode=debug、xdebug.start_with_request=trigger、xdebug.client_host=127.0.0.1；Docker 场景则改xdebug.client_host=host.docker.internal - PhpStorm 中确认
Settings > PHP > Debug > Xdebug > Debug port是9003，并勾选Start listening for PHP Debug Connections - 必须设置路径映射：在
Settings > PHP > Servers里新增条目，Host 填远程域名/IP，然后在Debugger > Use path mappings下，把本地/path/to/project映射到远程/var/www/myapp——这个映射和 Deployment 的 SFTP 映射不是一回事，少一个都不行
SFTP 自动上传不生效：不是同步失败，是触发条件没满足
不是 PhpStorm 同步机制坏了，而是它只在「显式上传」或「自动上传开启且文件保存时」才推代码。如果你开了 Automatic upload，但改完没按 Ctrl+S（或 Cmd+S），或者文件被外部编辑器锁住，就不会触发同步。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 打开
Tools > Deployment > Options，确保勾选了Upload changed files automatically to the default server - 检查
Files > Settings > System Settings > Synchronization，确认Save files on frame deactivation和Save files automatically if application is idle for N sec没被误关——否则切出 PhpStorm 窗口就可能漏传 - 如果用 Git 外部工具提交前修改了文件，记得先在 PhpStorm 里手动
Ctrl+S保存一次，否则 SFTP 不感知变更 - 测试时可用
Tools > Deployment > Browse Remote Host直接打开远程文件树，确认文件是否真没更新，排除 Web 服务缓存干扰
