scripts字段必须写在composer.json根对象下，格式为"scripts": {"脚本名": "命令字符串"或["命令1","命令2"]}，钩子名如post-install-cmd与post-update-cmd触发时机不同，路径需显式指定，执行失败会中断流程。
scripts字段写在哪、怎么格式化
必须写在composer.json根对象里，不是嵌套在config或extra下。顶层直接写"scripts"键，值是一个对象，键是脚本名（如"post-install-cmd"），值是命令字符串或数组。
- 单条命令用字符串：
"post-autoload-dump": "php artisan optimize:clear" - 多条命令用数组（按顺序执行）：
"pre-start": ["@php -v", "npm run build"] - 数组里以
@开头的项会递归解析为其他脚本，比如@dev会触发dev脚本 - 注意 JSON 双引号和转义：路径含空格或特殊字符时，需手动加引号，如
"php \"./bin/test.php\" --verbose"
常见钩子名别写错：post-install-cmd vs post-update-cmd
这两个最常混用，但触发时机完全不同——post-install-cmd只在首次composer install时运行（且vendor/为空），而post-update-cmd在composer update或带--with-dependencies的install时才跑。CI 环境里如果误用post-install-cmd，可能漏掉依赖更新后的清理动作。
-
pre-autoload-dump：生成自动加载文件前，适合改composer.json中autoload逻辑 -
post-autoload-dump：生成完vendor/autoload.php后，Laravel 的optimize:clear就得放这儿 -
post-root-package-install：仅在根项目（即你当前项目的composer.json）安装完成后触发，插件初始化常用
执行外部命令时路径和环境变量容易失效
Composer 执行脚本时工作目录是项目根目录，但PATH不一定包含vendor/bin，所以直接写phpunit常报command not found。也不能假设./bin或scripts/存在——它们得你自己建好。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 优先用
vendor/bin/phpunit而非phpunit，避免全局命令干扰 - PHP 脚本建议显式调用
php二进制："php ./scripts/deploy.php"，不依赖 shebang 或可执行权限 - 需要读取
.env？别指望它自动加载，脚本里得自己require或用putenv() - Windows 下
sh脚本不认，用cmd语法或统一走php封装
调试 scripts 为什么没运行
最常见原因是钩子名拼错、大小写不对，或者命令返回非零退出码导致 Composer 中断后续脚本（默认行为）。加上-v或--verbose能看到完整执行链，但更直接的是加echo打点。
- 临时加日志：
"post-install-cmd": ["echo '>> installing...', \"php -m | grep xdebug\"] - 检查是否被跳过：
composer run-script post-install-cmd手动触发，排除钩子注册失败 - 某些脚本（如
pre-autoload-dump）在composer dump-autoload时才生效，不是每次install都走 - 自定义脚本名（如
"build"）必须用composer run-script build显式调用，不会自动绑定到生命周期
钩子名大小写敏感、路径依赖明确、退出码决定流程走向——这些地方一松动，本地能跑 CI 就挂，而且错误信息往往藏在中间某条命令里，不打日志根本看不到哪一步断了。
