Composer scripts是唯一与依赖生命周期强绑定的自动化入口，仅适合执行轻量、确定性高的操作（如生成autoload、复制配置），严禁用于测试、打包等重任务，且生产部署必须禁用。
scripts 钩子不是“写个命令就行”，而是 Composer 里唯一能跨环境、自动触发、且与依赖生命周期强绑定的自动化入口——但它极易被滥用成“隐藏的构建脚本”，导致本地跑通、CI 失败、线上报错三件套。
scripts 能做什么：只做它该管的事
Composer 的 scripts 是在 composer install 或 composer update 后（或前）自动执行的命令列表，本质是 shell 命令代理。它适合做轻量、确定性高、与依赖状态直接相关的事：
- 生成 autoload 映射：
"post-install-cmd": "composer dump-autoload --optimize"—— 但注意，这不如直接用--optimize-autoloader参数可靠 - 复制/生成配置文件：
"post-root-package-install": ["@php -r \"copy('env.example', '.env');\""] - 清理 dev-only 文件：
"post-install-cmd": "rm -rf vendor/bin/phpunit vendor/bin/phpstan"（配合--no-dev使用才安全） - 触发轻量检查：
"pre-install-cmd": "php -v | grep -q '8.2' || exit 1"（用于提前拦截不兼容 PHP 版本）
别让它干重活：比如运行完整测试套件、打包前端资源、上传镜像——这些该交给 CI 工具或 Makefile 管理。
常见错误：scripts 执行失败却不报警
默认情况下，scripts 中某条命令失败，Composer 不会中断整个流程，除非你显式加 --no-scripts 或设置 "scripts": { "allow-plugins": false }。更危险的是：
-
composer install成功了，但post-install-cmd里的cp .env.example .env因目录不存在静默失败 → 线上启动直接报dotenv: file not found - 脚本中用了
php artisan key:generate，但 Laravel 未安装完成（autoload 还没就绪）→ 报Class 'App\Console\Kernel' not found - Windows 下写
rm -rf，Linux/macOS 下写del /q，没做平台判断 → CI 构建卡死
解决方案：所有关键脚本末尾加 && echo "✅ OK"，并在 CI 中用 grep -q "✅ OK" 校验输出；或改用 php -r 写跨平台逻辑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
scripts 和插件冲突：谁先执行？
当项目同时启用了 Composer 插件（如 roave/security-advisories）和自定义 scripts，执行顺序是：插件钩子优先于 scripts。例如：
-
pre-install-cmd→ 插件 pre-install 钩子 → 自定义 pre-install-cmd -
post-update-cmd→ 插件 post-update 钩子 → 自定义 post-update-cmd
这意味着：
- 如果你在
post-update-cmd里删vendor/bin，而插件刚把二进制写进去，就白删了 - 插件可能修改
composer.lock或 vendor 结构，导致你的脚本依赖的路径失效 - 想绕过插件？用
composer install --no-plugins，但要确认插件非必需（比如composer-require-checker就不该跳过）
生产部署时 scripts 必须禁用
CI/CD 流水线中，composer install --no-dev --optimize-autoloader 后，必须加 --no-scripts。原因很实在：
-
post-install-cmd里调php artisan config:clear，但线上没装phpunit或laravel/tinker，命令根本不存在 → 构建失败 - 某些脚本会尝试连接数据库或 Redis，而部署阶段网络策略尚未就绪 → 超时阻塞
-
dump-autoload -o在生产环境下毫无意义（--optimize-autoloader已在 install 阶段完成），反而多一次无谓的文件扫描
正确姿势是：开发期用 scripts 辅助 setup，上线前统一在 CI 脚本里写死 composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction --prefer-dist --no-scripts。scripts 的价值不在生产，而在降低新成员上手门槛——前提是它不越界。
