Mac M1配Xdebug Profiling需确保arm64架构匹配、php.ini正确配置xdebug.mode=profile,debug与xdebug.start_with_request=trigger、Web服务重启、URL带XDEBUG_PROFILE参数，且/tmp/xdebug有写权限。
Mac M1 上配 Xdebug Profiling 不难，但容易卡在路径、权限、配置开关三处——尤其是 xdebug.profiler_enable_trigger 没开或触发参数没带对，根本不会生成分析文件。
确认 PHP 和 Xdebug 版本匹配，避免编译失败
Apple M1 芯片必须用 arm64 架构的扩展，直接 pecl install xdebug 很可能装错架构（默认走 x86_64）。官方推荐做法是：
- 先运行
php -i | grep "PHP Extension Build"，看输出里是不是API20220829,NTS,arm64这类字样；不是就说明当前 PHP 是 x86_64 模式，得切架构再装 - 正确安装命令是：
arch -arm64 sudo pecl install xdebug - 装完后检查
php -m | grep xdebug有输出，再执行php --ri xdebug看是否显示Enabled和mode => profile,debug - 如果报
Cannot load module 'xdebug'，大概率是zend_extension路径写错了——M1 Homebrew 默认路径类似：/opt/homebrew/lib/php/pecl/20220829/xdebug.so，不是/usr/local/lib
php.ini 中 profiler 必须显式启用且设为 trigger 模式
Xdebug 3.x 默认关闭所有 profiling 功能，xdebug.mode=profile 单独写无效，必须和 debug 或其他 mode 合并，且要配合触发逻辑，否则每次请求都写文件，磁盘撑爆还拖慢响应。
- 在 php.ini 里加这组配置（注意不是
[xdebug]段，Xdebug 3 不认这个）： xdebug.mode=profile,debug-
xdebug.start_with_request=trigger（不是yes，否则全量采样） -
xdebug.profiler_output_dir="/tmp/xdebug"（确保目录存在且 PHP 进程有写权限：sudo mkdir -p /tmp/xdebug && sudo chmod 777 /tmp/xdebug） -
xdebug.profiler_output_name="cachegrind.out.%t.%p"（带时间戳和 PID，避免覆盖） - 删掉所有
xdebug.remote_*类旧配置（Xdebug 2 风格），它们在 3.x 里已废弃，留着反而干扰
访问时必须带 XDEBUG_PROFILE 参数，且 Web 服务要重启生效
很多人改完 php.ini 就去浏览器访问，结果 /tmp/xdebug/ 下空空如也——因为 PHP-FPM 或 Apache 并没重载新配置。
立即学习“PHP免费学习笔记（深入）”；
- 如果是 PHP-FPM（Laravel Valet / Docker / 自建）：
brew services restart php或sudo pkill -f 'php-fpm' && sudo php-fpm - 如果是 Apache：
sudo apachectl restart - 触发 profiling 的 URL 必须含参数：
http://localhost:8000/index.php?XDEBUG_PROFILE（大小写敏感，不能写成xdebug_profile或XDEBUG_PROFILE=1） - 访问后检查：
ls -l /tmp/xdebug/cachegrind.out.*，应该有文件生成，大小至少几 KB；为空或 0 字节说明没触发成功 - 如果用的是 Laravel Valet，还要确认它用的不是 CLI 的 php.ini，而是 FPM 的——
valet restart才真正生效
用 qcachegrind 查看报告前，先解决 dot 命令权限问题
Mac 系统完整性保护（SIP）禁止往 /usr/bin 写符号链接，所以网上常见的 sudo ln -s /usr/local/bin/dot /usr/bin/dot 在 M1 Mac 上会报 Operation not permitted。
- 别硬改系统目录，改
qcachegrind的配置更稳妥：启动它后，菜单栏点Settings → Configure Call Graph，把Dot executable改成/opt/homebrew/bin/dot（Homebrew 安装 graphviz 后的真实路径） - 确保已装
graphviz：brew install graphviz，否则 Call Graph 功能灰掉 - 打开报告后，默认是 Flat Profile 视图，想看调用关系图，点顶部
Call Graph标签页，等几秒渲染（大文件可能卡顿，可先用Filter限定函数名） - 如果报告里全是
{main}没子函数，说明 profiling 没捕获到实际执行——检查是否用了 opcode 缓存（如 Opcache）干扰了 Xdebug，临时关掉：opcache.enable=0再试
最容易被忽略的是：Xdebug profiling 只对「本次请求中实际执行的 PHP 代码」生成数据，如果路由走到静态文件、被 Nginx 直接返回，或者 PHP 进程提前 exit，就不会有 cachegrind 文件。建议先用一个最简 phpinfo(); 脚本验证整个链路是否跑通。
