如何在PhpStorm中为Xdebug设置自定义配置选项？

方法1：修改PHP全局配置（所有调试场景生效） #

直接编辑WSL环境里PHP的配置文件，比如php.ini或者Xdebug的独立配置文件（路径类似/etc/php/[你的PHP版本]/cli/conf.d/20-xdebug.ini，具体根据你的系统和PHP版本调整），添加或修改以下配置项：

xdebug.mode = debug
xdebug.client_port = 9003  # 替换成你需要的端口号
xdebug.client_host = "你的Windows主机IP"  # 比如192.168.1.100，可通过Windows网络设置或WSL内执行`hostname -I`获取

修改完成后，重启PHP-FPM（如果是Web应用）或者重新打开CLI会话即可生效。

方法2：针对单个Run/Debug配置设置（仅该配置生效） #

如果只想给特定的调试配置单独设置参数，不改动全局配置：

1. 打开PhpStorm，点击顶部菜单栏的Run > Edit Configurations
2. 在列表里选中你要修改的调试配置（比如PHP Script、PHPUnit这类CLI类型的配置）
3. 切换到Configuration标签页，找到Interpreter options输入框，填入以下参数：

-dxdebug.mode=debug -dxdebug.client_port=9003 -dxdebug.client_host=192.168.1.100

把端口和IP替换成你的实际值即可。

方法3：Web应用调试的额外配置 #

如果是调试Web应用（比如Apache/Nginx部署的项目），除了上面的配置外，还需要在PhpStorm里配置服务器映射：

1. 打开Settings > PHP > Servers
2. 确保服务器的Host和Port和你的Web应用地址一致
3. 勾选Use path mappings，把WSL里的项目路径对应到Windows主机上的项目路径
4. 注意此时Xdebug的client_host必须设为Windows主机的IP，保证WSL能访问到PhpStorm的调试端口

提示：你提到的dxdebug.client_hos是拼写错误，正确的参数名是xdebug.client_host。

内容的提问来源于stack exchange，提问作者k0pernikus