PHPStan必须本地安装，全局安装会导致配置失效、扩展无法注册、autoload_files不生效及文件静默跳过；正确做法是项目根目录执行composer require --dev phpstan/phpstan。
PHPStan 必须本地安装，全局安装等于没装
PHPStan 的配置加载、扩展发现、规则注册全部依赖 vendor/ 目录结构和 Composer 自动加载机制。全局安装（composer global require phpstan/phpstan）会导致：
– phpstan.neon 配置被完全忽略
– 自定义扩展（如 phpstan-extension）无法自动注册
– autoload_files 和 bootstrap 不生效
– 扫描时静默跳过文件，或报 Class not found 却不提示原因
正确做法只有一条：
– 进入项目根目录（确保有 composer.json）
– 运行 composer require --dev phpstan/phpstan
– 安装后可直接调用 vendor/bin/phpstan
phpstan.neon 配置里最常失效的两个参数
paths 和 level 看似简单，但错一个就白跑：
-
paths默认只扫src/，且要求文件有命名空间或class/interface声明；纯函数文件、无命名空间的.php会被直接跳过 -
level不是越高越好：v1.x 和 v2.x 对level含义不兼容（比如 v1.10 的 level 8 ≈ v2.0 的 level 5），升级前必须查对应文档 - 若项目用 PSR-4 但
composer.json的autoload没配好，PHPStan 加载不到类，会静默失败——不是报错，是“假装没看见”
建议起步配置：
parameters:<br> level: 5<br> paths:<br> - src<br> - tests<br> excludePaths:<br> - tests/bootstrap.php
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
立即学习“PHP免费学习笔记（深入）”；
为什么 vendor/bin/phpstan analyse 没报错，但实际没检查任何文件？
这不是 bug，是 PHPStan 的默认行为策略：
- 它只分析「能被自动加载的类/接口/trait 所在文件」，不扫描裸函数、配置数组、路由定义等
- 如果
src/下全是function helper()且无命名空间，phpstan analyse src/会输出[OK] No errors，但其实一行都没检查 - 验证是否真在扫描：加
--debug参数运行，看输出里有没有Analysing file行；没有，说明路径或 autoload 有问题 - 补救方式：在
phpstan.neon中显式加scanFiles，例如：parameters:<br> scanFiles:<br> - src/helpers.php<br> - config/routes.php
CI/CD 里跑 PHPStan 报错找不到类，但本地正常？
根本原因是 CI 环境未生成完整 autoload，尤其常见于 Laravel、Symfony 等框架项目：
- CI 中执行
composer install --no-dev后，vendor/autoload.php不包含开发依赖，而 PHPStan 的 bootstrap 或扩展可能依赖它们 - Laravel 项目未运行
php artisan ide-helper:generate，导致模型动态方法（$user->posts()）被误判为不存在 - 解决方案不是降级 level，而是补全环境：
– CI 脚本中加composer install --no-interaction（保留--dev）
– 若必须--no-dev，则提前把 PHPStan 相关 bootstrap 写进autoload_files，不依赖 vendor
真正麻烦的从来不是装不上，而是装上了却以为它在检查——结果漏掉 scanFiles、配错 phpVersion、或误信全局安装能跨项目生效。
