M3芯片Sequoia系统下VSCode中PHP调试断点失效问题求助

云上老周

2026-6-17

解决M3 Mac（Sequoia 15.0.1）Nginx环境下Xdebug断点不触发的问题

核心误区纠正

你误以为php.ini仅适用于Apache是错误的——Nginx通过php-fpm运行PHP，php-fpm会加载对应PHP版本的php.ini配置，所以修改正确的配置文件是有效的。

分步排查与解决

找到Nginx对应的PHP配置文件
MAMP for Apple Silicon中，每个PHP版本的配置文件独立存放，路径一般为：
/Applications/MAMP/bin/php/php8.2.2/conf/php.ini
（注意替换php8.2.2为你实际使用的PHP版本号）
配置正确的Xdebug参数
打开上述php.ini，添加或修改以下Xdebug配置（确保没有重复配置项）：
```
zend_extension="xdebug.so"
xdebug.mode=debug
xdebug.client_host=localhost
xdebug.client_port=9003
xdebug.start_with_request=yes
xdebug.discover_client_host=0
```
注意：xdebug.client_port要和VSCode的调试端口保持一致（默认是9003）。
验证Xdebug是否正确加载
1. 在Nginx的网站根目录新建phpinfo.php，内容为：
```
<?php phpinfo(); ?>
```
2. 访问该文件，搜索Xdebug关键字，确认是否存在Xdebug的配置信息，且参数和你设置的一致。
3. 也可以在终端执行php -v，如果输出中包含Xdebug版本信息，说明CLI环境下已加载，但仍需确认php-fpm环境的加载情况（以phpinfo页面为准）。

检查VSCode的launch.json配置
重点确认pathMappings配置，必须将Nginx中网站的绝对路径映射到VSCode的工作区路径，示例：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "/Applications/MAMP/htdocs/your-project": "${workspaceFolder}"
            }
        }
    ]
}

路径不匹配是断点不触发的常见原因，Xdebug无法关联服务器上的文件和本地VSCode中的文件。