直接运行composer install可能导致类找不到或模块加载失败，根本原因是vendor/autoload.php、vendor/composer/autoload_*.php及data/cache/中残留旧autoload映射与模块缓存，未随新composer.json配置同步更新；正确做法是先彻底清理这三处再执行install。
为什么重新执行 composer install 可能导致类找不到或模块加载失败
迁移 Laminas 框架（尤其是从 Zend Framework 2/3 到 Laminas 项目）后，直接运行 composer install 而不清理旧状态，常引发 Class not found 或 ModuleManager::loadModule(): Module "Application" could not be found。根本原因不是命令本身错，而是 vendor/autoload.php 和 vendor/composer/autoload_*.php 文件仍残留旧版本的 PSR-4 映射或 classmap 缓存，而新 composer.json 中的 autoload 配置已变更（例如从 "psr-0" 改为 "psr-4"，或模块路径从 module/Application/ 移至 modules/Application/）。
composer install 前必须手动清理的三个位置
别依赖 --no-cache 或 --ignore-platform-reqs —— 它们不清理本地生成的自动加载文件：
-
vendor/composer/autoload_psr4.php、autoload_classmap.php、autoload_files.php：这些是composer dump-autoload生成的，但install不强制重写，尤其当composer.lock未更新时 -
data/cache/（或config/cache/）下的模块配置缓存：Laminas 的ConfigAggregator或旧版ModuleManager会读取并复用过期缓存，跳过新模块注册 -
vendor/autoload.php文件本身：它只是引导器，但若其内部引用的autoload_static.php还指向旧路径，就会静默失效
正确做法是：rm -rf vendor/ data/cache/ && composer install（Linux/macOS），Windows 用户请用 rd /s/q vendor & rd /s/q datacache & composer install。
何时该用 composer install 而非 composer update
仅在以下情况用 composer install：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你已确认
composer.lock是迁移后生成的最新版本（比如刚执行过composer update laminas/laminas-code并提交了 lock 文件） - 部署到生产环境，且明确要求复现开发环境依赖版本（此时
install读 lock，update会忽略 lock 并拉取新版） - CI/CD 流水线中，需保证构建可重现性
其他所有迁移场景——包括本地开发、升级子组件、调整 autoload 配置——一律用 composer update，否则 install 会绕过你改过的 composer.json，继续装 lock 里锁死的旧包。
验证 autoload 是否生效的最快方式
不要等整个应用启动失败才排查。执行这条命令直接测试：
php -r "require 'vendor/autoload.php'; var_dump(class_exists('Laminas\Code\Generator\ClassGenerator'));"
返回 bool(true) 才算成功；如果返回 false，说明 autoload_psr4.php 未正确映射 LaminasCode 命名空间，大概率是 composer.json 中缺少 "laminas/laminas-code": "^4.0" 或版本冲突未解决。
真正麻烦的不是命令怎么敲，而是删不干净缓存、信错了 lock 文件、或者把 autoload 配置改在了错误的 composer.json（比如改了根目录的，却在 module 子目录下运行 install）。
