Composer脚本不能自动检测文件变更，需借助inotifywait、fswatch等外部工具实现热监控；其scripts仅支持手动或通过预定义钩子（如pre-install-cmd、post-update-cmd）触发，执行顺序严格按生命周期推进，且不支持自定义事件名。
Composer脚本怎么自动检测并触发？
Composer 本身不提供“自动检测文件变更后运行脚本”的能力，composer.json 中的 scripts 是纯手动或显式调用的（比如 composer install、composer run test）。所谓“自动检测”，必须靠外部工具配合，比如 inotifywait（Linux）、fswatch（macOS）、或 Node.js 的 chokidar。Composer 只负责定义脚本内容和执行入口。
- 不要在
composer.json里写监听逻辑——它没这个 runtime 环境 - 常见误操作：把
"post-install-cmd": "npm run build"当成“源码一改就重编译”，其实它只在composer install/update结束后跑一次 - 真正需要热检测时，应单独起一个监控进程，例如：
fswatch -o src/ | xargs -n1 composer run dev:build
哪些钩子能挂载脚本？执行顺序是怎样的？
Composer 定义了明确的事件生命周期，每个事件对应一组预置钩子（event），你只能往这些钩子上挂脚本，不能自定义新事件名。执行顺序严格按安装/更新流程推进，且同一钩子内多个脚本按声明顺序串行执行。
- 关键钩子（按典型
composer install流程排序）：pre-autoload-dump→post-autoload-dump→pre-install-cmd→post-install-cmd -
post-autoload-dump是最常被误用的点：它在 autoloader 生成后触发，但此时 vendor 还未完全就绪（比如某些插件类可能还没复制），不适合做依赖扫描类操作 - 若脚本依赖已安装的包（如调用
phpstan），必须挂到post-install-cmd或post-update-cmd，否则会报Class not found - 钩子名大小写敏感，
PostInstallCmd是无效的，必须全小写加短横线
如何让脚本只在特定环境下运行？
Composer 脚本本身没有内置环境判断，但可通过 shell 条件或 PHP 脚本包装实现。直接写在 composer.json 的字符串命令里，容易因引号、空格、平台换行出错；更稳妥的方式是封装为独立可执行文件或 PHP 类方法。
- 推荐写法：在
scripts中调用本地 PHP 文件，比如"post-install-cmd": "php ./scripts/check-env.php" - 检查环境变量示例（
check-env.php）：<?php if (getenv('APP_ENV') !== 'dev') { exit("Skip dev-only script\n"); } // do something... - 避免用
if [ "$APP_ENV" = "dev" ]; then ...这类 shell 写法：Windows 用户执行会失败，且 Composer 在不同平台对 shell 解析行为不一致
为什么有些脚本不执行？常见静默失败原因
Composer 脚本失败默认不中断主流程（除非显式配置 "exit-on-error": true），容易让人误以为“没挂上”。另外，非零退出码、输出重定向、错误抑制符都会掩盖问题。
- 脚本返回非 0 状态码但没设
"exit-on-error": true→ Composer 记录 warning 后继续，控制台可能只闪一下 - 用了
2>/dev/null或@php抑制错误 → 找不到报错源头 - 路径写死，比如
"php ./bin/console cache:clear"，但项目根目录下根本没有bin/console→ 直接静默失败 - 钩子挂载位置错误：想在依赖下载后校验，却挂在
pre-autoload-dump，此时vendor/autoload.php还没生成，require会 fatal error
钩子机制本身很稳定，问题几乎都出在脚本内容与执行时机的错配——尤其当多个团队成员共用一套 composer.json 时，有人加了个 post-update-cmd 却没考虑 CI 环境里缺少 Node.js，这种依赖隐含性最难排查。
