Composer 不运行测试，仅负责安装测试框架、配置自动加载和放置命令行脚本；漏任一环会导致 composer test 静默失败或 Class not found。

Composer 本身不运行测试，它只负责把测试框架装进来、让类能被自动加载、把命令行脚本放到 vendor/bin/ —— 三者缺一不可。漏掉任意一环，composer test 就会静默失败或报 Class not found。

autoload-dev 配错是 Class not found 的头号原因

测试类（比如 tests/Unit/ExampleTest.php）要被找到，必须和 composer.json 里 autoload-dev 的 PSR-4 规则完全对齐：

• "MyPackage\Tests\": "tests/" 要求文件路径为 tests/ExampleTest.php，且必须声明 namespace MyPackage\Tests;（注意末尾双反斜杠）
• 大小写敏感：写成 mypackage 或 Tests（少个 s）都不行
• 路径多一层（如 tests/src/）或少一层（如 test/）都会断链
• 无命名空间的辅助类（如 tests/support/TestCase.php）不能塞进 PSR-4，得改用 classmap 或 files 方式

dump-autoload --dev 不是可选项，是必跑步骤

改完 autoload-dev 后，Composer 不会自动更新映射 —— vendor/composer/autoload_dev.php 仍按旧规则加载。

Discussion Composer

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

下载

• 本地开发：每次改完 composer.json 中的 autoload-dev，立刻执行 composer dump-autoload --dev
• CI 环境：加 --optimize 生成 classmap，提速明显：composer dump-autoload --dev --optimize
• 别依赖 composer install 自动触发：它默认只处理 autoload，不处理 autoload-dev
• 常见现象：codecept run 或 phpunit 报找不到测试类，但 composer dump-autoload --dev 一跑就通

phpunit.xml.dist 和 autoload-dev 的 bootstrap 冲突最隐蔽

重复加载引导文件会导致常量重定义、函数已声明等静默崩溃，错误堆栈往往不指向真实源头。

• 检查 phpunit.xml.dist 是否有 <bootstrap>，如有，确认它没再 require 'vendor/autoload.php'
• 更安全的做法：删掉 phpunit.xml.dist 里的 <bootstrap>，让 Composer 的 autoload-dev 全权接管
• 若必须用自定义 tests/bootstrap.php，加防重入逻辑：if (!defined('BOOTSTRAP_LOADED')) { define('BOOTSTRAP_LOADED', true); }
• CI 报错但本地正常？先确认是否漏了 --dev 参数 —— composer install --no-dev 会让 autoload-dev 彻底失效

测试命令找不到，本质是路径和执行方式没理清

./vendor/bin/phpunit 和 ./vendor/bin/pest 是真实可执行文件，不是 shell 命令别名。

• Linux/macOS：必须用 ./vendor/bin/phpunit，直接敲 phpunit 会报 command not found
• Windows：用 vendor\bin\phpunit（注意反斜杠）
• 想省事？在 composer.json 的 scripts 里加："test": "php vendor/bin/phpunit"，然后跑 composer test
• 别手动把 vendor/bin 加进全局 PATH：多项目混用不同版本测试框架时，phpunit 命令会指向错误版本
• 验证是否真装对：./vendor/bin/phpunit --version 和跑一个空 it('works', fn() => true) 比什么都管用

最容易被跳过的动作，是改完 autoload-dev 后忘记 dump-autoload --dev；最容易被误判的问题，是把 bootstrap 冲突当成测试框架本身 bug。这两处卡住的人最多，但解决起来只要两行命令。