根本原因是PhpStorm默认只扫描Windows文件系统，不主动识别WSL中的/usr/bin/php等Linux路径；必须通过Remote Interpreter→WSL Configuration配置，选择对应发行版并填Linux格式路径，由PhpStorm自动调用wsl.exe执行。
PhpStorm找不到WSL里的PHP执行文件
根本原因是 PhpStorm 默认只扫描 Windows 文件系统，/usr/bin/php 这种 Linux 路径它压根不会主动去找。你不能把 wsl.exe -d Ubuntu php 当作解释器路径填进去——PhpStorm 的 CLI 解释器不支持 shell 命令封装。
正确做法是走 Remote Interpreter → WSL Configuration：
- Settings → Languages & Frameworks → PHP → Interpreter → “+” →
From Docker, Vagrant, VM, WSL, Remote…→ 选WSL -
Distribution下拉框里选你的发行版（如Ubuntu-24.04），别手动输名字，大小写和连字符必须完全一致 -
PHP executable path填/usr/bin/php（Linux 格式，不是\wsl$\Ubuntu\usr\bin\php） - 填完点 OK，PhpStorm 会自动用
wsl.exe -d Ubuntu --exec /usr/bin/php方式调用，无需你拼命令
如果提示 Cannot resolve PHP executable，先在 WSL 终端运行 which php 确认路径；再检查 wsl -l -v 是否显示该发行版状态为 RUNNING。
项目放在 /mnt/c/ 下却提示 “No such file or directory”
这是 WSL 对 NTFS 文件系统的权限与可执行位支持不稳定导致的。错误信息像 /bin/sh: /mnt/c/Users/name/project/script.sh: No such file or directory，本质不是路径不存在，而是 WSL 拒绝执行挂载卷上的脚本。
立即学习“PHP免费学习笔记（深入）”；
解决方式分两种场景：
- 开发主力项目：直接放 WSL 原生路径，比如
~/projects/myapp。在 PhpStorm 中点击File → Open，地址栏切换到WSL: Ubuntu视图，导航进去打开——此时所有操作都在 Linux 文件系统下，无权限异常 - 必须用 Windows 路径（如团队共享目录）：确保 WSL 已启用 metadata 支持，在
/etc/wsl.conf加入：[automount]<br>options = "metadata,uid=1000,gid=1000,umask=022"
然后wsl --shutdown重启
千万别把项目放在 C:\ 根目录或 OneDrive 同步目录下——这两处 NTFS 行为更不可控。
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南，适用于远程桌面访问、安全 RDP 等。
Composer 在 PhpStorm 终端里报 command not found
因为 PhpStorm 内置终端默认启动的是 PowerShell/CMD，而 composer 是个 Linux shell 脚本（开头有 #!/usr/bin/env php），Windows 命令行根本没法解析 shebang。
必须改终端 Shell：
- Settings → Tools → Terminal →
Shell path改成wsl（不带参数）或wsl ~ -e bash - 确保 WSL 发行版已设默认用户：
wsl --user yourname，否则终端可能卡在 root 登录 - Composer 路径不用额外配——只要终端进了 WSL，
which composer返回的路径就能直接用
如果终端启动后报 /bin/bash: No such file or directory，说明该发行版没装 bash，临时改成 wsl ~ -e sh，或重装发行版。
Xdebug 断点不触发，连接超时
WSL2 使用虚拟网卡，localhost 在 WSL 里指向自己，不是 Windows 主机。所以 xdebug.client_host=127.0.0.1 必然失败。
正确获取宿主机 IP：
- 在 WSL 终端运行：
cat /etc/resolv.conf | grep nameserver，取nameserver后的 IP（通常是172.x.x.1） - 把这个 IP 填进 PHP
php.ini的xdebug.client_host，例如：xdebug.client_host=172.28.0.1 - PhpStorm 中 Settings → Languages & Frameworks → PHP → Debug →
Debug port设为9003（Xdebug 3 默认），并勾选Can accept external connections - 确认 Windows 防火墙放行
9003端口，且没被杀毒软件拦截
路径映射漏配是另一个静默失败点：Run Configuration 里必须勾选 Use path mappings，左侧填 PhpStorm 项目路径（如 C:\wsl-projects\myapp），右侧填 WSL 中对应路径（如 /mnt/c/wsl-projects/myapp）——否则断点位置对不上。
