“cannot declare class”错误根源是psr-4 autoload注册了冲突路径导致同名类被重复加载，常见于多个包配置相同命名空间前缀、手动引入与自动加载重叠或vendor符号链接异常；需用composer dump-autoload -vvv定位生效映射，并通过exclude-from-classmap（仅限classmap）或修改name/autoload同步解决。
为什么require vendor/autoload.php后报“Cannot declare class”
这不是 autoload 没生效，而是它加载了两个同名类——PHP 不允许重复声明，直接 Fatal error。错误信息里出现的中文提示（如“类已定义”）只是 PHP 错误翻译层的表现，根源在 autoload 规则注册了冲突路径。
常见触发点：
- 两个包都在
composer.json中配置了相同的 PSR-4 前缀，比如都写了"App\": "src/" - 你手动
include过某个Helper.php，之后 Composer 又尝试加载同名类 - vendor 目录被符号链接挂载，导致
__DIR__在vendor/autoload.php里指向空路径，PSR-4 映射全部失效
var_dump(class_exists('SomeClass'));，返回 false 就说明根本没加载到正确类文件。
怎么快速定位是哪个包在注册冲突命名空间
别翻所有 composer.json，用 Composer 自带命令查：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer dump-autoload -vvv | grep -A5 -B5 "YourNamespace\"（把YourNamespace\替成你要查的，注意结尾反斜杠要转义） - 看输出里最后出现的那条映射，就是实际生效的路径
- 再用
composer show vendor/package-name查具体包的autoload字段 - 或者全局扫：
grep -r '"YourNamespace\\":' vendor/*/composer.json
exclude-from-classmap 能屏蔽冲突类吗
能，但仅对 classmap 生效，对 PSR-4 无效。
适用场景：
- 某个包的
vendor/package/src/下混着旧版 stub 类或测试工具类，它们有合法命名空间但不该参与自动加载 - 你无法改包源码，又必须集成它，且冲突类只出现在 classmap 扫描范围内
composer.json）："autoload": {
"exclude-from-classmap": ["vendor/conflict-pkg/src/DeprecatedHelper.php"]
}改完必须执行 composer dump-autoload，否则不生效。注意：这不能解决 PSR-4 映射重叠问题，比如两个包都声明 "Monolog\": "src/"，就得改包的 autoload 配置或用 replace。
fork 包后类还是找不到？name 和 autoload 必须同步改
Composer 报 Package xxx is already registered，是因为 name 字段是唯一键——哪怕 URL 不同、代码不同，只要 name 一样就拒绝加载。
改 fork 包必须做三件事：
- 改
composer.json的name，例如从"monolog/monolog"改成"acme/monolog"（别用"monolog_custom"这种易撞名的） - 如果命名空间也改了（比如从
Monolog\改成Acme\Monolog\），autoload里的 PSR-4 前缀必须同步更新 - 主项目中用
repositories指向新源，并在require里写新name；若其他依赖仍引用原包，还得加replace声明替代关系
name 不等于类就能自动加载，autoload 路径没对上，照样 Class not found。
