post-update-cmd失败主因是执行环境、时机或权限错配，非脚本逻辑错误；它在vendor/autoload.php生成前可能已触发，不自动加载类，且默认静默吞掉stderr，需加-v参数查看真实错误。
post-update-cmd 失败不是脚本写错了，而是执行环境、时机或权限没对上——它不自动加载类、不保证路径可靠、失败就中断整个 composer update。
为什么 post-update-cmd 什么都没输出就报错
Composer 默认吞掉脚本的 stderr，你只看到 “Script handling the post-update-cmd event returned with error code 1”，但不知道哪一行崩了。
- 必须加
-v参数重试：composer update -v或composer run-script post-update-cmd -v，才能看到真实 PHP 错误、Class not found或sh: php: not found - 如果输出里有
autoload.php相关错误（比如require(): failed to open stream），说明脚本在vendor/autoload.php生成前就被触发了 - Windows 下常见
'php' is not recognized：不是脚本问题，是 shell 找不到php，改用@php或绝对路径（如/usr/bin/php）
脚本里调用类却提示 Class not found 怎么办
post-update-cmd 在 autoload.php 写入完成前就可能运行，尤其当你的脚本放在 scripts 顶层、又直接 new 一个类时。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 别在
post-update-cmd字符串模式里直接 new 类；改用post-autoload-dump钩子，它确保vendor/autoload.php已就绪 - 如果坚持用
post-update-cmd，PHP 方法里开头加防护：if (!file_exists('vendor/autoload.php')) { exit(1); } - 自定义 PHP 类方法（如
MyClass::doSomething）必须是public static，且接受单个$event参数；Composer 不会自动 require 它，得靠autoload配置或提前加载
命令能手动跑通，但 post-update-cmd 里就失败
根本差异在于执行上下文：工作目录、PATH、权限、shell 初始化文件都不一样。
- 不要用相对路径如
./scripts/clear.php；Composer 当前工作目录虽是项目根，但某些 CI/IDE 会覆盖它；脚本内用__DIR__定位更稳 - 别依赖
$PATH里的全局命令（如phpcs、npm）；composer run不加载~/.zshrc，要么用全路径，要么显式export PATH=... - Linux/macOS 下检查脚本是否有可执行权限：
chmod +x scripts/deploy.php；Windows 下推荐统一写成"php scripts/deploy.php"，避免解释器识别失败 - 禁止在脚本里递归调用
composer install或composer update——锁文件正被占用，必然报failed to open stream: Resource busy
怎么确认 post-update-cmd 真的被触发了
它只在 composer.lock 实际变更后才运行，不是每次 composer install 都触发，也不是改了 composer.json 就立刻生效。
- 先确认是否真有更新：
composer outdated看哪些包可升；再改一个版本号（如"laravel/framework": "^10.0"→"^11.0"），再composer update - 检查配置位置：
post-update-cmd必须在composer.json的"scripts"对象下，不能写在"config"或顶层 - 运行
composer show --scripts，看输出里有没有post-update-cmd这一行；拼写、大小写、空格都敏感 - CI 环境默认常带
--no-scripts，记得检查 pipeline 脚本是否显式禁用了它
最易被忽略的是执行时机和退出码：脚本里任何逻辑失败，都必须显式 exit(1) 或抛异常，否则 Composer 认为成功；而 post-update-cmd 的“更新”指的是 composer.lock 文件内容变化，不是你主观觉得该更新了。
