Composer中autoload-dev字段在测试环境的应用（配置说明）-composer-PHP中文网

autoload-dev必须写在composer.json顶层，键名严格为“autoload-dev”，大小写、缩进或嵌套错误均导致静默失效；需执行composer dump-autoload --dev才生效，且仅在开发环境加载。

composer中autoload-dev字段在测试环境的应用（配置说明）

autoload-dev 必须写在 composer.json 顶层，拼错就失效

Composer 只认 autoload-dev 这个精确键名，大小写、缩进、嵌套位置全错不得。它必须和 autoload、require-dev 并列，是 composer.json 的一级字段。

常见错误写法：

"require-dev": { "autoload-dev": { ... } } —— 被完全忽略
"autoloadDev": { ... } —— 键名大小写错误，静默失效
"autoload-dev": { ... } 但缩进多了一格或少了一格（JSON 格式错误）——解析失败，配置丢弃

验证是否生效：运行 composer dump-autoload --dev 后，打开 vendor/autoload.php，搜索你的命名空间（比如 Tests），看有没有对应注册；或者直接检查 vendor/composer/autoload_dev.php 末尾数组里是否存在你写的映射。

psr-4 是测试类的默认选择，路径和 namespace 必须严格对齐

绝大多数测试类用 psr-4 最稳妥，但规则硬性：目录结构必须能从命名空间反推出来，且 PHP 文件里 namespace 声明必须和配置完全一致（末尾反斜杠是必需的）。

例如配置：

"autoload-dev": {
  "psr-4": {
    "Tests\": "tests/"
  }
}

那就要求：

tests/Unit/UserTest.php 里必须有 namespace TestsUnit;
tests/Feature/OrderTest.php 里必须有 namespace TestsFeature;
路径 tests/ 是相对于 composer.json 所在目录的

如果文件里写了 namespace AppTests; 却配了 "Tests": "tests/"，类就永远找不到——Composer 不 fallback，也不报错，只默默跳过。

Discussion Composer

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

下载

classmap 适合无 namespace 的辅助文件，但要手动刷新

classmap 不靠命名空间推导，而是直接扫描文件并建立类名到路径的静态映射，适合 tests/bootstrap.php、tests/helpers/ 这类没声明 namespace 或含全局函数的脚本。

但要注意：

每次增删文件后，必须重新运行 composer dump-autoload --dev，否则新文件不会被加载
别混用："psr-4": { "Tests\": "tests/" } 和 "classmap": ["tests/"] 同时存在，会导致 classmap 优先命中所有匹配文件，绕过 PSR-4 规则
避免扫整个 tests/ 目录——可能把 PHPUnit 自带的 Mock 类也扫进来，引发命名冲突

推荐只扫明确需要的子目录或具体文件，比如："classmap": ["tests/bootstrap.php", "tests/Support/"]。

CI/CD 中 autoload-dev 失效，大概率是漏了 --dev

本地跑得通、CI 报 Class not found？八成是因为 CI 脚本用了 composer install --no-dev，而你把测试路径配进了 autoload-dev。

autoload-dev 的映射只在启用开发依赖时才生成进 vendor/autoload.php。这意味着：

composer install 默认等价于 composer install --dev，会包含 autoload-dev
composer install --no-dev 会彻底忽略 autoload-dev 字段，连生成逻辑都不执行
composer update 或 composer install 都不会自动触发 autoload-dev 更新——必须显式运行 composer dump-autoload --dev