composer仅机械匹配psr-4命名空间前缀与文件路径，要求namespace声明、目录结构、大小写、反斜杠数量完全一致；下划线类名需用classmap；files不参与自动加载；自定义autoload必须移除以避免冲突。
Composer 不会“理解”命名空间语义，只做前缀字符串匹配 —— 配不配得对，取决于你写的 "App" 和类文件里写的 namespace App; 是否逐字符一致，以及路径是否真实存在。
PSR-4 映射必须严格对齐 namespace 声明
PSR-4 是当前唯一推荐的命名空间加载方式，但它不是“智能识别”，而是机械匹配。比如你在 composer.json 中写：
"autoload": {
"psr-4": {
"App\": "src/"
}
}
那就要求：
- 每个类的
namespace必须以App\开头，且反斜杠数量、位置完全一致（App或App都错） -
AppHttpControllerHome必须对应src/Http/Controller/Home.php，目录层级和大小写必须完全匹配（Linux 下http≠Http） -
src/目录必须真实存在于项目根目录下，不能是符号链接或拼写错误（如srс/） - 如果类文件里写的是
namespace appHttpController;（小写app），那它不会被"App\": "src/"匹配到
Legacy_、Old_ 这类下划线前缀不能用 PSR-4
像 Legacy_UserHelper、Old_Core_Utils 这种类名，哪怕你把它放进 legacy/ 目录，也无法用 PSR-4 加载 —— PSR-4 只解析反斜杠分隔的命名空间，对下划线类名完全无感。
正确做法是走 classmap：
"autoload": {
"classmap": ["legacy/", "old-lib/"]
}
然后运行：
composer dump-autoload
Composer 会扫描这些目录下所有 .php 文件，提取 class 和 interface 声明，生成静态映射表 vendor/composer/autoload_classmap.php。注意：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 新增类后必须重跑
composer dump-autoload，否则不会生效 - 扫描是递归的，但不支持通配符路径（如
"legacy/**/*.php"无效） -
classmap适合旧代码迁移过渡，性能略低于 PSR-4（因需预加载全部类路径）
files 不是用来加载类的，别指望它处理命名空间
files 的作用只有一个：在每次引入 vendor/autoload.php 时，无条件 include_once 指定文件。它不参与类查找流程，跟命名空间无关。
例如：
"autoload": {
"files": ["src/helpers.php"]
}
如果 helpers.php 里定义了：
function legacy_do_something() { ... }
class Legacy_Foo {} // ← 这个类仍然无法通过 new Legacy_Foo() 自动加载
那么 legacy_do_something() 可用，但 Legacy_Foo 仍会报 Class 'Legacy_Foo' not found。因为 PHP 的 autoload 机制根本不会触发 —— 它只在类未定义时才调用注册的加载器，而 files 是提前执行的。
混合项目中不要手动写 spl_autoload_register
很多老项目自己写了类似 autoload_client() 的函数来拼路径，结果和 Composer 的 PSR-4 规则冲突，反而导致类找不到或重复加载。
正确策略是：
- 彻底移除自定义
spl_autoload_register回调（或至少在引入vendor/autoload.php之前 unregister） - 把有命名空间的类（如
RedeStore）单独映射到对应目录："Rede\": "app/model_common/Rede/" - 对无命名空间的全局类，统一收口进
classmap扫描，而不是靠字符串替换猜路径 - 路径拼接务必确保尾部斜杠（
"app/model_common/Rede/"不能写成"app/model_common/Rede"）
最常被忽略的一点：Composer 的映射生成是静态快照，不是运行时逻辑。它不会读取你的环境变量、配置开关或条件判断 —— 所有路径和前缀都必须在 composer.json 里写死，且与实际文件结构一一对应。
