类找不到的主因是PSR-4映射不匹配：需确保本地包composer.json中"psr-4"配置、文件路径（如src/Http/Client.php）、命名空间声明（namespace MyPackageHttp;）三者严格一致，且大小写、层级、反斜杠数量均正确，否则自动加载静默失败。
本地包配置后类找不到，先检查 PSR-4 映射是否匹配
本地包 composer.json 里写的 "psr-4": {"MyPackage\": "src/"}，不代表 PHP 就能自动加载 MyPackageHttpClient。必须确保：文件路径 src/Http/Client.php 真实存在，且该文件顶部声明了 namespace MyPackageHttp;。命名空间末尾不能多写反斜杠，也不能漏掉子目录层级。
常见错误现象：
- 报错
Class "MyPackageHttpClient" not found，但文件和命名空间都看着“差不多” -
src/下是Client.php，却写了namespace MyPackage;（缺Http） - 用了大小写混用的目录名（如
src/http/Client.php），但 PSR-4 要求目录名与命名空间严格一致（Http≠http）
主项目 require 本地包后仍报命名冲突
不是包本身冲突，而是两个包注册了相同命名空间前缀，比如都用了 "App\" 或都用了 "Utils\"。Composer 不会报错，但运行时后加载的自动加载规则会覆盖先加载的，导致类被“静默替换”。
排查方法：
- 执行
composer dump-autoload -p（-p表示显示详细映射），搜索你的命名空间前缀，看它指向哪个路径 - 检查所有已安装包的
composer.json中autoload.psr-4，确认没有重复注册同一前缀 - 本地包尽量用唯一 vendor 名 + 独立命名空间，例如
"acme/json-validator": "dev-main"对应"Acme\JsonValidator\": "src/"
为什么 composer install 成功但运行时报 Cannot declare class X, because the name is already in use
这是典型的「同一类被多个自动加载规则加载两次」——通常因为本地包和主项目 src 目录都映射到了同一个命名空间前缀，或者本地包没加 autoload-dev 却把测试类也放进了 autoload.psr-4。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
关键点：
-
autoload是生产环境生效的，autoload-dev仅用于开发阶段（如测试类），两者不能混用 - 如果本地包的
tests/目录也被 PSR-4 映射了（比如写成"Acme\JsonValidator\": ["src/", "tests/"]），就可能把AcmeJsonValidatorTestHelper和主项目的同名类冲突 - 解决办法：把测试类单独放进
autoload-dev.psr-4，并确保主项目没做同样映射
本地包改了命名空间，但旧类还在自动加载缓存里
Composer 的自动加载器生成后不会自动感知命名空间变更，尤其是你手动改了 src/ 下某个文件的 namespace 行，但没清缓存或重生成映射。
必须执行：
-
composer dump-autoload --optimize --classmap-authoritative（强制重建权威类映射） - 删掉
vendor/composer/autoload_classmap.php和autoload_static.php再重跑 - 如果用了 OPcache，还需重启 PHP-FPM 或执行
opcache_reset()，否则旧映射仍在内存中
最隐蔽的坑是：你改了命名空间、跑了 dump-autoload，但没清 OPcache —— 报错依旧，还以为是配置问题。
