断点不触发、提示“cannot resolve path”或“no executable code found”，95%是路径映射未对齐：xdebug发送服务器绝对路径（如/var/www/html/index.php），而phpstorm在本地路径中查找，二者必须通过settings→php→servers中严格一对一映射。
PhpStorm 远程调试断点不触发、提示 “Cannot resolve path” 或悬停显示 “No executable code found”，95% 是路径映射没对齐，不是 Xdebug 没连上，也不是代码写错了。
为什么 __FILE__ 输出的路径和 PhpStorm 里看到的不一致
PHP 脚本在远程服务器（或容器）里运行时，__FILE__ 返回的是它在**服务器文件系统中的绝对路径**，比如 /var/www/html/app/index.php；而你在 PhpStorm 里打开的是本地项目路径，比如 /Users/you/project/app/index.php。Xdebug 把前者发给 PhpStorm，IDE 却在后者里找断点——自然找不到。
- 典型错误现象：断点图标变空心、调试器面板空白、控制台报
Cannot resolve path '/var/www/html/app/index.php' on server - 别靠猜：在 PHP 文件开头加
echo __FILE__; exit;，浏览器访问后看输出，这就是你要对齐的“服务器路径” - 如果用 Docker，这个路径是容器内路径（如
/app/index.php），不是宿主机路径 - 如果用 WSL2 或虚拟机，注意路径分隔符（Linux 用
/，Windows 本地用\），但 PhpStorm 映射只认正斜杠
Settings → PHP → Servers 里的 Web path 填什么
这个字段不是 URL 路径，也不是随便写的别名，它是服务器 DocumentRoot 下的**子目录相对路径**，必须以 / 开头，且严格匹配你实际部署的位置。
- 项目放在 Nginx/Apache 的根目录（如
/var/www/html），Web path就填/ - 项目放在子目录（如
/var/www/html/blog），Web path必须填/blog（不能少斜杠，也不能多斜杠） -
phpStudy 用户：本地项目路径是
D:\phpstudy_pro\WWW\api，则Local path填这个，Web path填/api - 填错后果：不仅断点失效，
Open in Browser也会 404，因为 PhpStorm 构造的 URL 根本不对
用 Docker 或远程服务器时，Path mappings 左右两边怎么配
这是最常翻车的一环。左侧是服务器上的真实路径（Xdebug 发来的路径），右侧是你本地项目的绝对路径（PhpStorm 打开的路径），两者必须一对一映射，不能有歧义。
- 左侧填
/var/www/html/myapp，右侧就填/Users/you/myapp（macOS）或D:\projects\myapp（Windows） - 不要把整个
/var/www/html映射到你本地根目录——除非你所有项目都放一起，否则会干扰其他项目 - Docker 场景下，左侧必须是容器内路径（如
/app），不是/host/path/app；右侧是你本地docker-compose.yml中volumes挂载的源路径 - 映射后立刻验证：在 PhpStorm 终端里执行
php -r "echo __FILE__;"，看输出是否被正确识别为已映射路径
路径映射生效但断点仍跳过，检查 xdebug.mode 和 CLI 上下文
路径对了，不代表 Xdebug 真在工作。特别是 CLI 脚本（如 Artisan、自定义命令）调试失败，往往卡在模式和配置加载上。
- CLI 模式默认不读 Web 用的
php.ini，运行php --ini确认 Loaded Configuration File 是哪个，编辑它，确保含xdebug.mode=debug -
xdebug.start_with_request=trigger对 CLI 无效——必须设为yes，或手动加参数：php -dxdebug.mode=debug script.php - 如果用
php -S内置服务器跑，它的 DocumentRoot 默认是当前目录，Web path应设为/，且路径映射左侧也得对应当前目录 - 不确定是否加载成功？临时在脚本里加
var_dump(xdebug_info());，看输出中xdebug.mode是否包含debug
路径映射不是一次配完就高枕无忧的事——换服务器、改部署结构、升级 Docker 镜像、甚至重装系统后 PATH 变动，都可能让映射瞬间失效。每次调试失灵，先看 __FILE__，再核对映射，最后查 php --ini，比重启 IDE 有用得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
