PhpStorm+WSL2+Docker环境下Xdebug.file_link_format路径前缀去除配置

你可以通过两种方式实现容器内路径前缀/var/www/html的去除，让Xdebug日志里的路径能直接跳转到PhpStorm的正确文件：

方法一：利用PhpStorm路径映射调整跳转格式 #

1. 打开PhpStorm，进入File > Settings > Languages & Frameworks > PHP > Servers
2. 添加新服务器，设置Host为你的容器访问地址（比如localhost），在Path mappings中，将容器内的/var/www/html映射到WSL中的项目根路径/home/me/www/project（对应Windows路径\\wsl$\Ubuntu-20.04\home\me\www\project）
3. 修改xdebug.ini中的配置：

   xdebug.file_link_format='jetbrains://php-storm/navigate/reference?project=project&path=/$PROJECT_ROOT$/%f:%l'
   

   PhpStorm会自动识别$PROJECT_ROOT$变量，结合路径映射转换容器路径为本地项目路径。

方法二：用自定义Shell脚本处理路径替换 #

如果PhpStorm的路径映射没生效，直接用脚本做硬替换更可靠：

1. 在容器内创建脚本/usr/local/bin/xdebug-link.sh，内容如下：

   #!/bin/bash
   # 移除容器内路径前缀
   CLEAN_PATH="${1/\/var\/www\/html\//}"
   # 输出PhpStorm跳转链接
   echo "jetbrains://php-storm/navigate/reference?project=project&path=${CLEAN_PATH}:${2}"
   

2. 给脚本添加执行权限：

   chmod +x /usr/local/bin/xdebug-link.sh
   

3. 修改xdebug.ini配置，让Xdebug调用脚本生成正确链接：

   xdebug.file_link_format='/usr/local/bin/xdebug-link.sh %f %l'
   

内容的提问来源于stack exchange，提问作者C. Leo