PHPStan必须本地安装，全局安装会导致配置忽略、扩展无法注册、autoload失效等问题；应使用composer require --dev phpstan/phpstan，并正确配置paths、level和bootstrap。
PHPStan 必须本地安装，全局安装等于没装
PHPStan 的配置加载、扩展发现、规则注册全部依赖 Composer 的 vendor/ 目录结构和自动加载机制。全局安装（composer global require phpstan/phpstan）会导致：
– phpstan.neon 配置被完全忽略
– 自定义扩展（如 phpstan-phpunit）无法自动注册
– autoload_files 或 bootstrap 不生效
– 扫描时静默跳过文件，或报 Class not found 却不提示原因
- 永远用
composer require --dev phpstan/phpstan（项目根目录执行） - 确认生成了
vendor/bin/phpstan，而不是指望全局phpstan命令 - 不同项目可能需要
phpstan/phpstan:^1.10或^2.0，本地安装才能隔离版本
phpstan.neon 里最常配错的三个参数
很多人跑完 vendor/bin/phpstan analyse 看到 [OK] No errors 就以为万事大吉，其实只是 PHPStan 根本没扫描你的代码——默认只扫 src/，且要求文件有命名空间或类声明；autoload 没配对，它连 use 的类都解析不了，直接跳过整文件。
-
paths：必须显式列出源码目录，比如- src、- app、- lib；别漏掉tests/（如果想检查测试代码） -
level：从5起步，不是越高越好；level: 9会强制要求完整泛型类型（如@var array<string, User>），旧项目容易批量爆Variable type could not be inferred -
autoload_files或bootstrap：Laravel、Symfony 等框架项目务必加，否则找不到app()、config()等辅助函数，报一堆“Function not found”
为什么 composer analyse 报错说找不到命令
这是 composer.json 脚本配置写错的典型表现。PHPStan 安装后只是放在 vendor/bin/ 下，不会自动注册为 Composer 命令；你得手动加进 scripts 字段，而且不能漏掉引号或写错大小写。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确写法（在
composer.json的scripts对象里）："analyse": "phpstan analyse" - 错误写法举例：
–"analyse": "phpstan analyse src/"（硬编码路径，CI 中可能失效）
–analyse: phpstan analyse（缺引号，JSON 解析失败）
–"analyze": "phpstan analyse"（拼错单词，composer analyze就无效） - 验证方式：运行
composer run，看输出里是否列出analyse
老项目接入 PHPStan 的现实策略
直接开 level: 8 然后跑全量分析？大概率刷出几百个错误，团队立刻放弃。真实落地要分阶段：先让工具“看见代码”，再逐步收紧。
立即学习“PHP免费学习笔记（深入）”；
- 第一步：用
vendor/bin/phpstan analyse --generate-baseline生成phpstan-baseline.neon，把当前所有错误记下来但不报错 - 第二步：在 CI 中加
--configuration=phpstan-baseline.neon，确保新提交不引入新问题 - 第三步：每周 fix 5–10 个 baseline 错误，删掉对应行，慢慢收窄范围
- 注意：
--generate-baseline不解决autoload问题——如果连类都加载不了，baseline 里记的其实是“跳过”，不是“已知错误”
PHPStan 真正麻烦的不是装不上，而是装上了却以为它在检查——结果漏掉 paths、配错 phpVersion、或误信全局安装能跨项目生效。截至 2026 年 3 月，这点依然没变。
