composer的autoload配置必须写在项目根目录的composer.json文件顶层"autoload"字段中，而非vendor或插件内；修改后须手动执行composer dump-autoload才能生效。
Composer 的 autoload 配置写在哪？
在项目根目录的 composer.json 里加 "autoload" 字段，不是插件或 vendor 里改——改了也没用，Composer 只读你项目的顶层配置。
常见错误是把配置写进某个包的 composer.json，或者误以为运行 composer install 就自动生效，其实必须手动执行 composer dump-autoload（或带 -o 优化 autoload）才刷新映射。
-
"psr-4"最常用：适合有命名空间、目录结构规整的工具类，比如"App\Utils\": "src/Utils/" -
"classmap"适合无命名空间的老式工具类，直接扫目录下所有.php文件生成类名→路径映射 - 别混用
psr-4和files加载同一类——可能因加载顺序导致重复定义 fatal error
PSR-4 自动加载工具类时命名空间和路径怎么对齐？
PSR-4 不是“猜路径”，它靠命名空间前缀 + 目录路径拼接定位文件。比如配置了 "MyTools\": "lib/"，那么 new MyToolsFileHelper() 就会去找 lib/FileHelper.php，而不是 lib/MyTools/FileHelper.php。
容易踩的坑：类文件放在 lib/MyTools/FileHelper.php，但命名空间写成 MyTools（少了一级），结果 Composer 找不到；或者命名空间写成 MyToolsUtils，却没在 autoload 里配 "MyToolsUtils": "lib/Utils/"。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保类文件里的
namespace声明与autoload中的前缀完全一致（包括末尾反斜杠） - 路径末尾不加
/也能工作，但加了更清晰，推荐统一加 - 修改后必须运行
composer dump-autoload，否则vendor/autoload.php不更新映射
老项目没有命名空间的工具函数怎么让 Composer 加载？
用 "files" 方式最直接：它会在每次请求时 require 指定的 PHP 文件，适合纯函数集合（如 helpers.php）。这种方式不依赖类或命名空间，也不走 PSR 规则。
注意："files" 是全局加载，只要引入了 vendor/autoload.php，里面定义的函数就立刻可用——哪怕没 new 任何类。这很方便，但也容易污染全局作用域。
- 只放真正需要“随处可用”的函数，避免把业务逻辑塞进去
- 文件路径写相对路径（相对于
composer.json），比如"lib/helpers.php" - 如果多个
files定义了同名函数，后面加载的会覆盖前面的，PHP 报Fatal error: Cannot redeclare xxx()
为什么 dump-autoload 后还是 Class not found？
90% 是路径或命名空间没对上，剩下 10% 是缓存或加载时机问题。先确认 vendor/autoload.php 是否被正确引入（通常在入口文件第一行），再检查类是否真的在映射路径下、文件名是否匹配类名（大小写敏感！Linux 下尤其明显）。
另一个隐蔽点：Composer 默认不会 autoload dev 依赖中的类，除非你在 autoload-dev 里单独配，或者把工具类移到主 autoload 区域。
- 用
composer show -p查看当前 autoload 映射是否包含你的类名 - 临时加一句
var_dump(class_exists('YourClass'));快速验证是否注册成功 - 如果用了 opcache，记得
opcache_reset()或重启 PHP-FPM，否则旧映射可能还在内存里
vendor/composer/autoload_psr4.php 里生成的数组长什么样。
