必须先安装匹配版本的phpstan/phpstan再装nunomaduro/larastan，配置phpstan.neon包含includes和bootstrapFiles，并确保Laravel版本与Larastan兼容。
直接装 larastan 会失败，因为 PHPStan 不是靠 Composer “安装”进项目的
PHPStan 和 Larastan 的关系不是“插件式扩展”，而是“分析器 + 配置”。larastan 本身不提供可执行命令，它只是为 PHPStan 提供 Laravel 特定的规则、类型补全和扩展配置。所以你不能只运行 composer require --dev nunomaduro/larastan 就完事——缺了 PHPStan 主体，larastan 根本跑不起来。
常见错误现象：phpstan analyse 报错 Command "analyse" is not defined，或直接提示找不到 phpstan 命令。
- 必须先装
phpstan/phpstan（推荐^1.10或^2.0，Larastan 1.x 对应 PHPStan 1.x；Larastan 2.x 要求 PHPStan 2.x） - 再装
nunomaduro/larastan，版本需严格匹配（查 Larastan 兼容表） - 两者都得加
--dev，静态分析工具不该进生产环境
phpstan.neon 配置写错位置或漏掉 includes，Larastan 规则完全不生效
Larastan 不会自动注册自己——它靠 phpstan.neon 里的 includes 显式加载。如果你只装了包但没改配置，PHPStan 仍用默认规则，对 app()、resolve()、Eloquent 关系等统统“视而不见”。
典型表现：明明用了 Post::query()->where('id', $id)->first()，却报 Call to an undefined method Illuminate\Database\Eloquent\Builder::first()。
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 配置文件必须叫
phpstan.neon（不是.neon或phpstan.yaml），放在项目根目录 - 必须包含
includes:块，且路径指向vendor/nunomaduro/larastan/extension.neon - 别漏掉
parameters:下的level:（建议从5起步，8太激进，大量误报）
includes:
- vendor/nunomaduro/larastan/extension.neon
<p>parameters:
level: 5
paths:</p><ul><li>app</li><li>database/factories</li><li>database/seeders运行 phpstan analyse 卡住或报路径错误，其实是 autoloader 没加载 Laravel 框架
PHPStan 默认只加载 composer.json 里定义的 autoload 规则，但 Laravel 的服务容器绑定、Facade 别名、模型动态属性等，依赖 bootstrap/app.php 和框架启动流程。不模拟这个环境，PHPStan 就看不懂 Auth::user() 返回什么类型。
错误信息示例：Class App\Models\User not found（即使类存在），或 Call to undefined method Illuminate\Support\Facades\Auth::user()。
- Larastan 要求你提供一个
bootstrapFiles，通常指向tests/Bootstrap.php或自建的phpstan-bootstrap.php - 这个文件里要手动
requireLaravel 的autoload.php和app.php，并调用$app->boot() - 别把整个
bootstrap/app.php直接塞进去——它依赖$_ENV和 CLI 环境，容易爆错
升级 Laravel 后 phpstan analyse 大量报错，大概率是 Larastan 版本没同步更新
Larastan 的类型映射紧贴 Laravel 源码。Laravel 10 移除了 Illuminate\Support\Str::random() 的第二个参数，但旧版 Larastan 还按老签名推导，就会误判调用错误。
这种问题不会在 CI 上立刻暴露，因为本地可能缓存了旧的 PHPStan 分析结果，或者只扫了部分目录。
- 每次 Laravel 升级后，先查
nunomaduro/larastan的CHANGELOG.md，确认是否支持新版本 - 用
composer show nunomaduro/larastan和composer show laravel/framework核对版本号 - 如果 Larastan 暂未适配，宁可降级 PHPStan（比如从 2.x 退回 1.10.x），也不要硬扛——误报会淹没真实问题
Larastan 的核心难点从来不在安装命令，而在于它必须和 Laravel 的生命周期“对齐”。少一个 bootstrapFiles，漏一行 includes，或版本差一个小点，分析结果就不可信。很多人跑通命令就以为成了，其实第一轮扫描出来的 90% 报错，都是环境没搭对。
