如何在Composer中配置本地包的PSR-4加载-composer-PHP中文网

composer本地包自动加载需四步：1.本地包composer.json中正确配置psr-4（如"mylib": "src/"）；2.项目根目录composer.json声明path型repositories指向该包；3.composer require的包名须与本地包name字段完全一致；4.执行composer dump-autoload刷新映射表。

如何在composer中配置本地包的psr-4加载

本地包的 `composer.json` 必须有正确 `autoload` 配置

本地包不是“放进去就能用”，它的自动加载能力完全取决于自身 composer.json 中的 autoload 字段。如果你只配了项目根目录的 autoload，而本地包里没写 "psr-4"，那 Composer 加载时根本不知道从哪找类。

psr-4 键值对必须存在，且命名空间结尾带双反斜杠："MyLib\": "src/" ✅，"MyLib": "src/" ❌（会被当 PSR-0 处理，现代 Composer 默认跳过）
路径值必须是相对路径、末尾带斜杠："src/" ✅，"src" 或 "./src/" ❌（后者在某些系统下解析为空）
类文件结构必须严格匹配：类名 MyLibServicesApiClient → 文件路径必须是 src/Services/ApiClient.php，大小写一个都不能错
如果本地包目录下没有 src/，或该目录为空，composer dump-autoload 仍会成功，但运行时必报 Class not found

项目根目录要声明 `repositories` 并指向正确路径

Composer 不会主动扫描你硬盘上的任意文件夹。想让本地包被识别，必须在项目根目录的 composer.json 里显式声明一个 path 类型仓库。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

repositories 必须是根级数组：{"repositories": [{"type": "path", "url": "./packages/my-lib"}]} ✅，不能塞进 require 或其他字段里
url 是相对于项目 composer.json 的路径，不能用绝对路径（如 /home/user/packages/my-lib）或 file:// 前缀，否则静默失效
确保 ./packages/my-lib 目录真实存在，且里面包含合法的 composer.json（至少含 name 和 autoload）
若本地包未设 version 字段，项目需配置 "minimum-stability": "dev"，否则 dev-main 这类分支名会被过滤掉

`composer require` 包名必须和本地包 `name` 完全一致

执行 composer require 时填的字符串，不是路径，也不是目录名，而是本地包 composer.json 里定义的 name 字段值——大小写、连字符、命名空间分隔符都必须一字不差。

比如本地包 composer.json 写的是："name": "acme/http-client"，你就得运行 composer require acme/http-client
写成 acme/httpclient、ACME/HTTP-CLIENT 或 http-client 都会报 Could not find package
这个错误和网络、缓存无关，纯粹是匹配失败；Composer 不会提示“你是不是想用本地包”，它只查已声明的仓库