post-install-cmd在composer install后触发，适用于首次安装等场景；post-update-cmd在composer update后触发，适合开发者主动更新时执行较重操作，二者语义不同、错误影响范围不同，应区分使用。
直接在 composer.json 的 scripts 里配 post-install-cmd 和 post-update-cmd，调用 ide-helper:generate 等命令即可。但要注意：这两个钩子触发时机不同、权限环境不同、错误处理也不同——不加区分地全写进去，反而容易在 CI 或队友本地安装时崩掉流程。
post-install-cmd vs post-update-cmd：什么时候该用哪个
两者都可用于生成 IDE 元数据，但语义和风险差异很大：
-
post-install-cmd在composer install后执行，包括首次克隆项目、CI 构建、Docker 构建等场景——一旦脚本报错（比如数据库不可达导致ide-helper:models失败），整个安装流程就中断，且错误常被淹没在大量输出中 -
post-update-cmd只在composer update后触发，通常发生在开发者主动更新依赖时，失败影响范围小，适合放较重的生成逻辑 - 更稳妥的做法是只保留
post-update-cmd，再额外定义一个手动触发脚本（如ide-generate），让 CI 或部署脚本按需调用，避免“自动”变成“强制”
ide-helper 命令必须带 --no-interaction 才能进钩子
像 ide-helper:models 默认会交互式询问“是否覆盖现有文件”，在非 TTY 环境（如 CI、IDE 右键 reload）下会卡住或直接失败。所有进 scripts 的命令都得加 -n 或 --no-interaction：
@php artisan ide-helper:generate -n-
@php artisan ide-helper:models -N（-N是laravel-ide-helper特有参数，等价于--no-interaction） @php artisan ide-helper:meta -n
漏掉这个，脚本可能在某次 composer update 后静默挂起，你只能杀进程再重试。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
生成的文件必须进 .gitignore，否则团队协作必冲突
ide-helper 生成的三个核心文件：_ide_helper.php、_ide_helper_models.php、.phpstorm.meta.php 都不该提交到 Git：
- 它们内容高度依赖当前 vendor 和模型结构，不同人运行后生成结果必然不同
- 若有人手动生成并提交，另一个人
composer update后再生成，Git 会标为冲突，但其实只是时间戳/顺序差异，无实质合并意义 - 正确做法是在
.gitignore里加三行：_ide_helper.php、_ide_helper_models.php、.phpstorm.meta.php
顺带一提：ide-helper:generate 默认输出到项目根目录，别试图改路径——PHPStorm 只认默认位置，改了 IDE 就找不到。
PHPStorm 没识别新生成的元数据？不是没生成，是没索引
即使脚本成功运行、文件已写出，PhpStorm 仍可能继续标红类或属性。这不是 Composer 或插件问题，而是 IDE 缓存未刷新：
- 右键项目根目录 → Reload project（它会触发
composer install，顺便重建索引） - 或手动触发：File → Reload project from Disk
- 如果还无效，检查 Settings → PHP → PHP Language Level 是否匹配项目实际版本（比如用了 PHP 8.2 的特性，但 IDE 设成 7.4，类型提示照样失效）
真正容易被忽略的是：生成脚本成功 ≠ IDE 立即可用。中间差了一层索引，而这一步完全不依赖 Composer，只靠你点一下鼠标或快捷键。
