PSR-4与classmap混用会导致类加载失败：PSR-4因命名空间不匹配跳过，classmap因无有效类声明忽略；须严格区分用途，避免同一类名跨规则配置，且路径、命名空间、大小写必须完全一致。
autoload字段里混用psr-4和classmap导致类加载两头不靠
PSR-4 和 classmap 是两种不同机制：前者靠命名空间+目录结构匹配，后者靠文件路径直接映射。一旦你同时配了 "App\": "src/" 和 "classmap": ["src/Utils.php"]，而 Utils.php 里又没声明 namespace App;，Composer 就会跳过 PSR-4（因为命名空间不匹配），又忽略 classmap（因为 classmap 只认 class/interface/trait 声明，且该文件可能没被扫描进 classmap 表）。
实操建议：
- 同一类名不能同时出现在两种规则中，否则行为未定义；Composer 默认以 PSR-4 为准
- 无命名空间的老代码（如
database/seeds/）必须单独走classmap，别塞进 PSR-4 - 全局函数文件（如
helpers.php）只能放files字段，不是classmap，也不是psr-4 - 验证是否生效：运行
composer dump-autoload -v，看终端是否输出Generating optimized autoload files (using classmap)
命名空间前缀与实际PHP文件声明不一致
PSR-4 不是“模糊匹配”，它要求 composer.json 中的命名空间前缀（如 "App\"）和 PHP 文件里的 namespace 声明**逐字符严格相等**，包括末尾反斜杠、大小写、甚至空格。
常见错误现象：
- 配置写成
"App": "src/"（少一个反斜杠），但 PHP 文件里是namespace AppHttpControllers;→ 不匹配 - 目录是
src/http/controllers/，但 namespace 是AppHttpControllers;→ Linux 下大小写敏感，文件找不到 - 类文件叫
usercontroller.php，但类名是UserController→ PSR-4 要求首字母大写的文件名
快速验证：运行 composer dump-autoload 后，直接 var_dump(include 'vendor/composer/autoload_psr4.php');，检查数组里是否有你配的键，值是否指向正确路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
autoload-dev 和 autoload 配置互相干扰
autoload 和 autoload-dev 是两套完全独立的配置。如果你把测试类（如 tests/TestCase.php）只写在 autoload-dev 里，却在 PHPUnit 运行时 require 了 vendor/autoload.php（它默认只加载 autoload），那测试类就根本不会被加载。
使用场景：
- 生产环境只用
autoload，autoload-dev完全不生效 - 运行测试时，PHPUnit 默认加载
vendor/autoload.php，但它不自动包含autoload-dev—— 除非你在phpunit.xml里显式配置bootstrap或改用vendor/bin/phpunit --bootstrap vendor/autoload.php - 开发中想让 IDE 或 CLI 直接识别测试类？得单独执行
composer dump-autoload --dev
路径值缺少尾部斜杠或大小写错位引发静默失败
PSR-4 的路径值（如 "src/"）必须是相对于 composer.json 所在目录的**真实相对路径**，且必须带尾部斜杠。写成 "src" 看似一样，但在拼接时会变成 srcMyClass.php，而不是 src/MyClass.php，结果就是 file_exists() 返回 false，然后 Composer fallback 到其他规则或直接报错。
容易被忽略的地方：
- Linux/macOS 下，
Src/和src/是两个目录，哪怕你配置了"App\": "Src/"，但文件放在src/下，也加载不到 - Windows 开发者常忽略这点，一到 CI/CD（Linux 环境）就崩
- 路径里混入中文路径、空格、或不可见字符（如 U+200B）也会导致
file_exists()失败，建议用cat -A composer.json查看
真正起效的验证方式不是“能跑”，而是打开 vendor/composer/autoload_static.php 或 autoload_classmap.php，搜索你的类全名，确认它是否出现在映射表里——这才是自动加载真正的依据。
