自动加载失败主因是本地path仓库类路径未注册进autoload_psr4.php或autoload_classmap.php，根源在于name字段不一致、url路径错误、symlink未启用或未更新映射。
自动加载失败不是 Composer 没扫描到你的包，而是它压根没把本地 path 仓库的类路径注册进 autoload_psr4.php 或 autoload_classmap.php——绝大多数情况，问题出在 name 字段不一致、路径未指向含 composer.json 的目录，或 symlink fallback 后你改了代码却没刷新映射。
确认 path 仓库的 name 和 require 完全一致
Composer 不做模糊匹配。大小写、分隔符（只认短横线 -）、vendor 名，必须逐字相同。
-
"acme/utils"≠"Acme/utils"≠"acme_utils"≠"acme/utils"（末尾多空格也不行） - 检查本地包根目录下的
composer.json：必须有"name": "acme/utils"，且该值与主项目require中写的字符串一模一样 - 运行
composer show --all | grep acme/utils，如果没输出，说明仓库根本没被识别，优先查 name
验证 url 是否指向含 composer.json 的目录（而非文件或父级）
url 字段必须是目录路径，且该目录下存在合法的 composer.json；路径是相对于主项目 composer.json 的位置，不是 shell 当前路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误示例：
"url": "../my-pkg/composer.json"（指向文件）、"url": "../my-pkg/"（末尾斜杠可能被某些 PHP 版本截断） - 正确写法：
"url": "../my-pkg"，然后手动执行ls -la ../my-pkg/composer.json确认存在 - Windows 用户避开中文、空格、长路径；Docker 中需确保挂载卷权限支持读取该路径
检查是否真用了 symlink，还是 fallback 到 copy
你改了本地代码却没生效？大概率是 symlink 创建失败后静默 fallback 成复制，vendor 里存的是旧副本。
- 关键点不在主项目配置，而在**本地包自己的
composer.json中是否声明了"options": {"symlink": true}** - Linux/macOS：运行
ls -la vendor/acme/utils，看到->才是 symlink；否则就是 copy - Windows：用
dir vendorcmeutils，看到<SYMLINKD>或JUNCTION才对；若为普通文件夹，立刻补上本地包的options - Windows 需管理员权限运行终端；Docker 需加
--cap-add=SYS_ADMIN并确认挂载方式支持 symlink
确认 autoload 映射已更新且路径推导正确
即使 symlink 生效，类仍找不到，说明 PSR-4 前缀映射没生成，或路径推导时多/少了一层目录。
- 先运行
composer dump-autoload -v，看输出里有没有扫到你的命名空间（如Acme），若没有，说明 autoload 配置未生效 - 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀，确认映射的物理路径是否是你本地包的 src 目录绝对路径 - 例如配置了
"Acme\": "src/"，但类AcmeHttpControllersHomeController实际在src/Acme/Http/Controllers/HomeController.php，就会因多一层Acme/导致推导失败 - 修改本地包的
composer.json后，必须在主项目中运行composer update acme/utils（不是install）才能刷新 symlink 和 autoload 映射
最易忽略的是：本地包改完代码后，只运行 composer install 是无效的；install 不重建已有链接，dump-autoload 也不触碰 symlink —— 必须 update 指定包名，且本地包自身要带 "options": {"symlink": true}。
