PHPStan安装失败本质是ZIP包损坏或缓存污染，须先删vendor、清缓存、确认composer.lock未修改，再换阿里云镜像源重试，否则重复失败。
PHPStan 必须本地安装，网络中断导致的安装失败，本质是 ZIP 包损坏或缓存污染，不是配置或权限问题——重试前先清理 vendor 和缓存，再换阿里云镜像源，否则大概率重复失败。
为什么 composer require --dev phpstan/phpstan 会卡住或报错
这不是 PHPStan 本身的问题，而是 Composer 在下载 phpstan/phpstan 或其依赖（如 phpstan/extension-installer、phpstan/phpstan-laravel）时，因网络抖动导致 ZIP 文件不完整。常见现象包括：
Failed to extract vendor/phpstan/phpstan: unable to open archive-
Invalid argument supplied for foreach()（源于vendor/composer/installed.json被截断） -
cURL error 28: Operation timed out或Connection refused
这些错误说明 Composer 已拿到损坏的 ZIP 缓存，后续重试会复用它，永远无法通过。
中断后必须执行的三步清理操作
别跳过任何一步，顺序不能乱：
立即学习“PHP免费学习笔记（深入）”；
- 删掉整个
vendor/目录：rm -rf vendor（Linux/macOS）或rmdir /s vendor（Windows） - 清空 Composer 全局缓存：
composer clear-cache（它会删掉~/.composer/cache/files/下所有 ZIP） - 确认
composer.lock文件未被修改——如果它被意外编辑或 git checkout 覆盖过，重装前先git checkout composer.lock
做完这三步，composer install 才会从头拉取干净包，而不是复用坏缓存。
换镜像源比调 timeout 更治本
国内用户 90% 的 PHPStan 安装失败，根源是直连 packagist.org 或 GitHub API 不稳定。镜像源解决的是 DNS、TLS 握手、CDN 距离三重瓶颈，不是单纯“提速”：
- 全局配阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾无斜杠） - 验证是否生效：
composer config -g repo.packagist应输出该 URL，不是packagist.org - 私有包（比如公司内部扩展）不受镜像影响，需单独在
composer.json里加repositories配置
配完立刻重试：composer require --dev phpstan/phpstan phpstan/phpstan-laravel phpstan/extension-installer。Laravel 项目缺任意一个，Auth::user() 都会被推断为 mixed。
验证 PHPStan 是否真正加载成功
装完不代表能用——全局安装、autoload 配错、路径写漏都会让 PHPStan 静默失效：
- 运行
./vendor/bin/phpstan analyse --debug app/Http/Controllers，输出里必须含Loading extension from vendor/phpstan/phpstan-laravel/extension.neon - 检查
phpstan.neon中paths:是否带尾部斜杠：- src/✅，- src❌（部分版本会跳过子目录） - 执行
php -r "var_dump(class_exists('PHPStan\Analyser\NodeScopeResolver'));"，返回bool(true)才说明 autoloader 加载成功
最容易被忽略的是：PHPStan 只扫描「能被自动加载的类文件」，纯函数文件、无命名空间的路由定义默认不分析——这不是 bug，是设计行为。
