php insights 必须本地安装，因其依赖项目配置文件 phpinsights.php 和 vendor/autoload.php 实现类加载与路径识别；全局安装会导致配置缺失、类无法解析及规则失效。
PHP Insights 不能直接通过 Composer 安装为全局工具，必须以项目本地依赖方式安装，否则 phpinsights 命令会找不到配置、无法加载规则、甚至报 Class not found 错误。
为什么必须用 composer require --dev 而不是 composer global require
PHP Insights 的核心逻辑严重依赖项目级配置（phpinsights.php）和当前项目的自动加载器（vendor/autoload.php）。全局安装时，它既读不到你的项目配置，也无法正确解析你项目中定义的类（比如自定义指标或扩展），导致运行时报 ReflectionException 或跳过所有自定义规则。
- 本地安装后，
vendor/bin/phpinsights启动时自动包含项目autoload.php，能识别App\、Tests\等命名空间 - 全局安装的二进制文件没有上下文感知能力，会尝试用它自己的 autoloader 加载你的项目类，必然失败
- 即使加了
--config参数指定路径，也解决不了类加载问题
composer require --dev nunomaduro/phpinsights 后要立刻做的三件事
安装只是第一步，不手动干预，90% 的人会在首次运行时遇到 No insights were found 或 Too few arguments。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
php vendor/bin/phpinsights configure生成phpinsights.php—— 不要跳过，它会根据composer.json的autoload和autoload-dev自动推导目录范围 - 检查生成的
phpinsights.php中'paths'是否包含你的真实源码目录（如['app/', 'src/']），默认可能只写了['src']，而你的代码在app/ - 确认
'preset'值是'laravel'、'symfony'或'default'之一；设成不存在的字符串会导致静默跳过所有检查
CI 环境下运行 phpinsights 失败的常见原因
GitHub Actions / GitLab CI 报 PHP Fatal error: Allowed memory size exhausted 或卡死，不是 PHP Insights 本身的问题，而是 Composer + Xdebug + 内存限制的组合陷阱。
- CI 默认启用 Xdebug（尤其 PHP ≥ 8.2），而 PHP Insights 在分析时会大量反射类，Xdebug 会指数级放大内存消耗 —— 运行前加
php -d xdebug.mode=off vendor/bin/phpinsights - Composer 安装时用了
--no-dev？那phpinsights根本没装进去，CI 构建镜像里查不到vendor/bin/phpinsights - 用了 Docker 镜像但没挂载
phpinsights.php配置？它不会 fallback 到 preset 默认值，而是直接退出并提示Configuration file not found
最常被忽略的是：PHP Insights 的检查结果依赖于当前 composer install 后生成的 vendor/autoload.php 结构。如果中途改过 composer.json 的 autoload 规则但没重装依赖，它就会漏掉某些目录，且不报错、不提醒。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
