post-install-cmd并非每次composer install都执行，仅在vendor为空或composer.lock缺失/过期导致依赖重建时触发；常见失效原因包括scripts未置顶层、ci启用--no-scripts、缓存未清理及误用pre-autoload-dump调用未加载类。
Composer 的 hooks（如 post-install-cmd、pre-autoload-dump）不是“写了就跑”，失败时往往静默跳过，根本原因通常不在脚本逻辑本身，而在执行时机、环境上下文或配置对齐缺失。
post-install-cmd 为什么根本没触发？
它只在真正重建 vendor/ 时才运行，不是每次 composer install 都执行。常见失效场景包括：
- 项目已有
vendor/且composer.lock未变 → Composer 直接跳过安装流程，钩子不启动 -
scripts字段没放在composer.json顶层，而是误写在extra或autoload下 - CI 环境默认加了
--no-scripts，所有脚本被强制禁用 - 本地测试前没清掉
vendor/和composer.lock，导致你以为“重装”其实只是复用缓存
脚本里 new Class 报 Class not found 怎么办？
很多钩子（尤其是 pre-autoload-dump）在 vendor/autoload.php 生成前就执行，此时自动加载器还不存在。错误不是类没装，而是“还没准备好”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 别在
pre-autoload-dump中调用需 autoload 的类；改用post-autoload-dump或post-install-cmd - 若必须提前检查，加防护：在脚本开头写
if (!file_exists('vendor/autoload.php')) { exit(1); } - 注意工作目录：Composer 执行脚本时
cwd是项目根目录，但某些 CI 或 IDE 可能覆盖它，别依赖相对路径如../src
加 -v 也看不到真实错误？
默认情况下 Composer 会吞掉子进程的 stderr，-v 是唯一可靠手段——但它只显示到第一层，深层命令崩溃仍可能被掩盖。
- 立刻重试：
composer install -v或composer run test -v，重点盯输出末尾几行 - 看到
sh: php: not found或'php' is not recognized？问题不在 PHP 版本，而在 shell 找不到php命令 —— 改用全路径如/usr/bin/php或 Composer 自带的vendor/bin/phpunit - 脚本中用了
exec()或shell_exec()？确保对应命令（如node、git）在 PATH 中，且权限足够
Git 钩子类工具（CaptainHook / GrumPHP）不生效的硬性条件
它们不是 Composer 的“功能”，而是靠 Composer 安装二进制，再靠手动或脚本往 .git/hooks/ 写文件。漏掉任一环节就彻底静默。
-
.git/hooks/pre-commit文件必须存在且有可执行权限：chmod +x .git/hooks/pre-commit -
captainhook.json或grumphp.yml中对应钩子的enabled必须为true（默认常是false） -
triggered_by列表要匹配你实际修改的文件后缀，比如只配["php"]，但改了.js就不会触发 - Windows 用户注意：
.git/hooks/下的 shell 脚本默认无法执行，推荐统一用 WSL，或明确文档要求 bash 环境
最易被忽略的是：这些钩子的生命周期完全独立于 Composer，composer install 成功 ≠ 钩子已注册，vendor/bin/captainhook install 必须显式运行一次，且后续新成员 clone 后还得靠 post-install-cmd 自动补上——而这一步本身又受前面所有条件制约。
