post-install-cmd 上线后不执行，主因是生产环境使用 --no-dev 参数导致 composer v2+ 默认跳过所有 scripts；需显式启用或改用 composer run-script 触发，且 scripts 必须置于根 composer.json 顶层。
生产环境部署时 post-install-cmd 不执行，不是脚本写错了，而是默认被跳过。 因为 Composer 在 --no-dev 模式下会同时禁用所有 scripts（包括 post-* 钩子），除非显式启用或改用 composer run-script 手动触发。
post-install-cmd 为什么上线后不运行
本地 composer install 能清缓存、生成配置，CI/CD 流水线里却静默跳过——根本原因是：生产部署通常带 --no-dev 参数，而 Composer v2+ 默认在该模式下忽略所有 scripts，哪怕它们写在根 composer.json 里。
- 检查是否误加了
--no-scripts：这个参数会彻底关闭所有钩子，连post-update-cmd也失效 -
post-install-cmd只在composer install成功后触发，但若 lock 文件缺失或 vendor 已存在，它可能根本不进入 install 流程 - CI 环境中
.git目录常被裁剪（shallow clone），导致post-install-cmd里依赖.git的逻辑（如复制 hooks）直接失败
scripts 字段必须放在根 composer.json 顶层
很多人把 scripts 嵌套进 extra 或 config 里，或者写在依赖包的 composer.json 中——这些都不会生效。Composer 只读取项目根目录下 composer.json 的顶层 scripts 对象。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 支持的 key 必须是标准事件名：
post-install-cmd、post-update-cmd、post-root-package-install、post-create-project-cmd - 自定义脚本名（如
deploy:clear-cache）不会自动触发，只能靠composer run-script deploy:clear-cache显式调用 - 数组值按顺序执行，字符串值会被 shell 解析，含空格或引号时建议拆成数组项
执行权限和路径问题比想象中更常见
php artisan cache:clear 在本地成功，部署时报 Permission denied，大概率不是代码问题，而是用户、路径或 PHP CLI 配置不一致。
- 脚本始终在项目根目录执行，但
storage/目录属主可能是www-data，而部署用户是deploy，需提前chown -R deploy:www-data storage/ - 避免用
php artisan，改用php ./artisan或php -d memory_limit=-1 ./artisan，防止 CLI ini 覆盖 web 配置 - 别依赖当前 shell 的
$PATH，比如chmod可能找不到，用/bin/chmod更稳妥
复杂逻辑务必抽离为独立 PHP 文件
脚本里写一长串 find | xargs php -l 或嵌套 if 判断，在 Windows CI 或低权限容器里基本不可靠。PHP 回调方法又要求类可被 autoload，容易因加载顺序出错。
- 最稳做法：写一个
scripts/deploy.php，开头require __DIR__.'/../vendor/autoload.php';，然后封装全部逻辑 - 在
composer.json里调用："php scripts/deploy.php" - 这样既能用完整 PHP 生态（异常捕获、日志、配置读取），又规避了 shell 兼容性和环境变量污染问题
真正难的不是写脚本，而是让同一段命令在本地开发、CI 构建、Docker 部署、线上服务器四个环境里都稳定跑通——路径、权限、用户、PHP 配置、Git 状态，任何一个变量没对齐，post-install-cmd 就会变成“看起来写了，其实没跑”的幽灵逻辑。
