PHPStan必须本地安装，全局安装无效；正确做法是项目根目录执行composer require --dev phpstan/phpstan，配置phpstan.neon并显式指定paths和level，确保autoload映射正确。

PHP 项目里所谓“Composer 中文包管理中的强制类型约束”，本质是用 Composer 安装 PHPStan（或其他静态分析工具），再靠它在不运行代码的前提下发现类型错误——不是 Composer 本身提供类型检查，而是它帮你把 PHPStan 装进项目、配好路径、拉起 autoload 链路。

phpstan analyse 报 “Class not found” 却类明明存在

这不是类写错了，是 PHPStan 根本没找到你的类文件。它不读 composer.json 的 autoload 映射来猜路径，必须你手动告诉它去哪扫。

• paths 必须显式列出所有含 PHP 类的目录：Laravel 项目要加 - app、- database、- routes；Symfony 项目常见 - src + - tests；纯函数文件（如 src/helpers.php）得单独放进 autoload_files
• composer.json 的 autoload.psr-4 必须真实覆盖这些目录，否则 PHPStan 反射时无法把 App\User 映射到 app/Models/User.php
• 别信“自动识别”——vendor/autoload.php 没生成（composer install 或 composer dump-autoload -o 没跑）或路径多斜杠（"src//"）、含环境变量（"${SRC_DIR}/"）都会让映射失效

level 设置太高导致第一次运行就崩溃

PHPStan 的 level 不是开关，是渐进式校验强度。设成 level: 9 却项目里满屏 array、mixed、无返回类型函数，它会直接卡在解析阶段或报一堆“Unknown type”。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 从 level: 5 开始：能捕获未定义属性、方法调用错误、空值解引用等硬伤，对大多数项目足够实用
• 逐步升级：修复完 level: 5 所有报错后，再试 level: 7，最后考虑 level: 9（要求全类型声明）
• 别把 vendor/ 或 tests/fixtures/ 加进 paths——前者内存溢出，后者若没配 autoload-dev 就触发 Class not found

composer require phpstan/phpstan 为什么是危险操作

这条命令默认写进 require 字段，等于把 PHPStan 当成运行时依赖装进生产环境。它不是库，是开发期分析器，加载它的 autoloader 会污染容器、引发命名冲突（比如你有个 Static 类）、甚至悄悄引入 phpunit。

• 必须用 composer require --dev phpstan/phpstan，确认 phpstan/phpstan 出现在 composer.json 的 require-dev 下
• 已误装？先 composer remove phpstan/phpstan，再重装；composer show phpstan/phpstan 输出里应含 dev-master 或类似标记，而非列为 “required package”
• Laravel 项目不能只装 nunomaduro/larastan——它是扩展，主体仍是 phpstan/phpstan，二者缺一不可

phpstan.neon 文件名、位置、缩进一个都不能错

PHPStan 不会报错说“配置没读到”，它只会安静 fallback 到默认行为：只扫 src/、level: 0、跳过所有 autoload 映射。验证是否生效，唯一可靠方式是加 --debug 看输出。

• 文件名必须是 phpstan.neon（不是 .neon、phpstan.yaml 或 phpstan.neon.dist），且放在项目根目录（和 composer.json 同级）
• parameters: 块必须存在，level 和 paths 必须在其下缩进（YAML 敏感，推荐 2 空格）
• 运行 vendor/bin/phpstan analyse --debug，检查输出中：Loaded configuration 是否指向你的 phpstan.neon；Scanning files in 是否列出你预期的路径（如 app/Models/User.php）；是否有 Using bootstrap file: vendor/autoload.php —— 没这行说明 autoload 链路断了

真正难的不是跑通命令，而是让 phpstan.neon 的 level 和 paths 贴合项目真实结构，同时不让 autoload_files 变成运行时入口——这两处配错，静态分析就只剩形式主义。