php-metrics 不是可 autoload 的 php 库，而是通过 composer bin 机制安装的独立 cli 工具；需指定具体版本（如 2.8.0）并加 --dev 安装，生成 vendor/bin/phpmetrics 命令，不可直接 require 或 new 实例。
PHP-Metrics 本身不提供 Composer 官方包，直接 composer require 会失败——它是个独立 CLI 工具，不是可 autoload 的 PHP 库。
为什么 composer require phpmetrics/phpmetrics 报错或装不上
PHP-Metrics 没有注册到 Packagist，也没有维护 composer.json 的自动加载配置。它的发布方式是 GitHub release 打包的 PHAR 文件，而非标准 PSR-4 包。试图用 Composer 安装会导致：
Could not find package phpmetrics/phpmetrics- 或装上但
require失败（类未注册 autoload） - 即使手动下载源码，也缺少
autoload声明，vendor/autoload.php不识别
正确安装方式：用 Composer 管理 PHAR 文件
官方推荐用 Composer 的 bin 机制下载并暴露命令行工具，而不是当库加载。执行：
composer require --dev phpmetrics/phpmetrics:2.8.0
注意三点：
- 必须指定具体版本（如
2.8.0），不写^2.8或dev-master—— 否则可能拉到不兼容的开发分支 - 加
--dev，因为生成报告属于开发期行为，不应进入生产依赖 - 安装后，
phpmetrics命令会自动软链到vendor/bin/phpmetrics
生成报告时的关键参数与路径陷阱
运行命令前确认当前目录是项目根目录（含 composer.json），否则扫描路径易出错。常用命令示例：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
vendor/bin/phpmetrics --report-html=reports/metrics --exclude="tests/,vendor/" ./src
容易踩的坑：
-
--exclude的路径必须以/结尾（如tests/），否则排除失效 -
./src必须存在且可读；若用.扫全项目，会把vendor误算进去（除非显式--exclude） - HTML 报告路径
reports/metrics会自动创建目录，但父目录reports/若不可写会报错，提前mkdir -p reports更稳 - PHP 8+ 用户注意：PHP-Metrics 2.8 支持 PHP 8.0–8.2，但不支持 8.3+；升级前先查
phpmetrics --version
无法在代码里 require PHP-Metrics 类的原因
它没有提供命名空间类入口，所有逻辑封装在 PHAR 内部，启动靠 phpmetrics 脚本调用 Phar::loadPhar()。你不能在自己的 PHP 脚本中写：
// ❌ 这样不行 require_once 'vendor/autoload.php'; use PhpMetrics\Report\HtmlReport; // 类不存在，autoload 不生效
如果真需要嵌入调用（比如 CI 中动态生成），唯一可行路径是：
- 用
exec()或shell_exec()调用vendor/bin/phpmetrics - 解析其 stdout 或生成的 HTML/JSON 输出
- 别尝试 include PHAR 文件——PHAR 内部依赖相对路径，脱离 CLI 上下文会崩
所谓“在项目中使用”，实际就是把它当黑盒 CLI 工具管好路径、权限和版本，别幻想当普通 Composer 包来 new 实例。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
