Composer pre-钩子失败时需加--verbose查看真实stderr输出，因其在autoload生成前运行，类不可用且错误易被静默；脚本须显式exit(1)或抛异常，避免路径、权限及递归调用陷阱。
pre-钩子（如 pre-install-cmd、pre-update-cmd）失败时，Composer 默认不输出真实错误，只报 “Script xxx handling the yyy event returned with error code 1”——你得先让错误浮上来，再定位是路径、权限、autoload 还是提前退出的问题。
加 --verbose 看真实 stderr 输出
pre 钩子在 autoload 生成前就运行，很多类还不可用，PHP 错误（比如 Fatal error: Class 'Monolog\Logger' not found）会被静默吞掉。不加 -v 就像蒙眼修车。
- 必须重跑：例如
composer install -v或composer update --dry-run -v - 注意输出里带
Executing command的那行，后面紧跟着的就是脚本真实 stderr，包括PHP Notice、Warning、file_get_contents(): failed to open stream - 如果脚本是 PHP 类方法（如
My\Script::check），错误可能出现在activate()或构造函数里，-v会显示插件加载过程，帮你确认是否走到那一步
检查脚本是否依赖未生成的 vendor/autoload.php
pre 钩子执行时机早于 autoload.php 生成，但很多人在脚本里直接 require 'vendor/autoload.php' 或 new 一个项目类——这必然失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要在
pre-install-cmd或pre-update-cmd里 requirevendor/autoload.php；它此时物理文件都还没写入磁盘 - 如果必须用项目代码，改用
require __DIR__.'/../vendor/autoload.php'并加存在性判断：if (!file_exists(__DIR__.'/../vendor/autoload.php')) { echo "autoload missing, skipping"; exit(0); } - 更稳妥的做法：把需 autoload 的逻辑挪到
post-install-cmd或post-update-cmd，它们保证autoload.php已就绪
确认脚本退出码非零且不静默失败
Composer 只认退出码，不看 echo 或 print。脚本里只输出错误却不 exit(1)，它就当成功继续跑。
- PHP 脚本中检测失败后必须显式退出：
if (!$config) { echo "config.json missing\n"; exit(1); } - 类方法中推荐抛异常：
throw new RuntimeException('env not ready')，Composer 会自动捕获并转为错误退出 - Shell 脚本同理：末尾别漏
exit 1，尤其用了set -e时要注意命令链中断是否被覆盖 - 避免只写
echo "error"+ 没后续动作——这是最常被忽略的“假失败”
排查路径、权限与递归调用陷阱
pre 钩子常被用来做环境校验或清理，但一不小心就会踩进路径错乱、权限不足或自己调自己（composer install 套娃）的坑。
- 脚本内别用相对路径如
./scripts/check-env.php；当前工作目录虽通常是项目根，但某些 CI 或 IDE 会覆盖它，统一用__DIR__定位 - Linux/macOS 下，若 pre 脚本是 shell 文件（如
bin/pre-check.sh），必须chmod +x bin/pre-check.sh；Windows 用户请显式写"php bin/pre-check.php"，别依赖 shebang - 绝对禁止在
pre-install-cmd里调composer install或composer update——锁文件正被父进程占用，必卡死或报failed to open stream: composer.lock - Docker/CI 场景下，检查
vendor/和composer.lock所属用户是否与容器内 UID 一致；不一致时即使加了+x，execve() 也会拒绝执行
pre 钩子失败最难 debug 的地方在于：它发生在整个安装流程最前端，所有辅助设施（autoload、插件、缓存）都还没就位。所以不能靠“试”，得靠 -v 抓原始输出，靠路径和退出码做确定性判断——任何模糊处理都会让问题滑向更下游。
