composer install无法进入xdebug断点，是因为其通过proc_open()启动的子进程不继承父进程xdebug配置；需显式启用：xdebug_mode=debug php -dxdebug.mode=debug composer install，并确认cli php.ini已正确配置xdebug.mode=debug。
为什么 composer install 无法进入 Xdebug 断点？
默认情况下，Composer 会用 proc_open() 启动子进程执行脚本（比如 post-install-cmd），而这些子进程不会继承父进程的 Xdebug 配置，导致断点失效。不是 Xdebug 没装好，是它根本没加载进子进程里。
实操建议：
- 在命令前显式启用 Xdebug：运行
XDEBUG_MODE=debug php -dxdebug.mode=debug composer install - 确保
xdebug.mode=debug在 CLI 的php.ini中已设置（不是 Apache/FPM 的配置） - 检查
php --ini输出的配置路径，确认 CLI 使用的是你修改的那个php.ini - 若用 PhpStorm，需勾选
Run > Debug > Break at first line in PHP scripts，否则 Composer 自身启动逻辑跳过断点
如何调试自定义 Composer 命令（如 vendor/bin/my-command）？
这类命令本质是独立 PHP 脚本，但常被 Composer 的 bin-wrapper 包裹一层 shell 脚本，直接 php -dxdebug.mode=debug vendor/bin/my-command 会失败——因为 wrapper 会重定向到真实 PHP 文件，Xdebug 参数丢失。
实操建议：
- 先用
composer show --help或查看vendor/bin/my-command文件头，确认它是否为 Unix wrapper（通常以#!/usr/bin/env php开头） - 如果是 wrapper，改用
php -dxdebug.mode=debug $(readlink -f vendor/bin/my-command)直接调用真实文件 - 若使用 Windows，用
php -dxdebug.mode=debug vendor\bin\my-command.bat不起作用，应找到.php源文件路径手动调试 - 推荐在脚本开头加
if (function_exists('xdebug_break')) xdebug_break();，避免依赖 IDE 自动断点
composer run-script 调试时变量作用域丢失怎么办？
Composer 执行脚本时默认用 eval() 或 include() 加载，但若脚本中用了 use、global 或闭包，Xdebug 可能无法正确映射变量作用域，导致 Watch 窗口显示 undefined 或值为空。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 避免在
scripts中写长逻辑；把核心代码移到独立类中，脚本只做调用 - 在
composer.json的scripts里改用完整命令："test-debug": "php -dxdebug.mode=debug -f scripts/test.php" - 检查
xdebug.overload_var_dump=0（默认为 1），否则 var_dump 输出可能被截断或格式错乱，影响调试判断 - 若用 Laravel Mix、Symfony Console 等框架封装的命令，优先调试其
handle()方法入口，而非 Composer script 字符串
CLI 下 Xdebug 连接失败的常见配置陷阱
即使启用了 xdebug.mode=debug，也常因端口、IDE key 或路径映射问题连接不上。错误现象包括：PHP 进程无响应、IDE 显示 “Waiting for connection…”、日志里出现 Connection refused。
实操建议：
- 确认
xdebug.client_host设为127.0.0.1（不是localhost，某些系统 DNS 解析慢或失败） -
xdebug.client_port必须与 IDE 监听端口一致（PhpStorm 默认 9003，旧版是 9000） - CLI 的
xdebug.idekey应设为与 IDE 中配置的 key 一致（如PHPSTORM），且大小写敏感 - Windows WSL 用户注意：IDE 在 Windows，PHP 在 WSL，
xdebug.client_host应设为 Windows 主机 IP（如192.168.1.100），并确保防火墙放行该端口
最易被忽略的一点：Xdebug 4 要求 xdebug.start_with_request=yes 或显式触发（如 XDEBUG_SESSION_START=1），仅靠 xdebug.mode=debug 不足以自动启动调试会话。
