Path仓库被Packagist覆盖是因为未在repositories中显式声明对应path源，且必须将该path项置于数组最前面；否则Composer会优先从Packagist匹配同名包。
Path仓库为什么总被Packagist覆盖
Path仓库（"type": "path"）只在你显式require一个本地路径包时才生效，它不参与全局元数据匹配。如果你写了"my-company/utils": "dev-main"，但没在repositories里声明对应path源，Composer就会忽略本地目录，转头去Packagist找——哪怕你本地真有那个目录。
常见错误现象：composer install成功，但vendor/my-company/utils却是从Packagist拉的远程包，不是你改了三小时的本地代码。
- 必须在
repositories中显式添加一项：{"type": "path", "url": "./packages/utils"}（注意url是相对路径，且不能以../开头） - Path项要放在
repositories数组**最前面**，否则同名包可能先被Packagist或镜像命中 - Path仓库不支持版本约束语法如
^1.0；它只认dev-main、dev-develop这类分支名，或带subdir的子目录结构 - 修改本地包后，必须运行
composer update my-company/utils --no-install再composer install，否则composer.lock仍指向旧哈希
禁用Packagist后Path仓库还能用吗
能，但必须满足两个硬性条件：一是{"packagist.org": false}必须作为独立对象写在repositories数组末尾；二是所有非Path包（比如laravel/framework）都得有对应镜像源，否则直接报Package not found。
典型翻车场景：你加了{"packagist.org": false}，又只配了Path源，然后composer require monolog/monolog——结果报错，不是因为Path不行，是因为Monolog根本没在任何已声明源里。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 禁用
packagist.org后，Composer不会自动 fallback 到其他type: "composer"源；它只会查你repositories里明确定义过的每一个源 - Path源和Composer源可以共存，顺序上建议：Path → 私有Composer源 → 阿里云镜像 →
{"packagist.org": false} - 验证是否生效：运行
composer config repositories，输出中不应出现"https://repo.packagist.org"，且应看到"packagist.org": false作为单独数组项
Path仓库与VCS仓库混用时的优先级陷阱
Path和VCS都是“按需触发”，但触发逻辑完全不同：Path只响应require里带本地路径的包名（如"my-company/utils"），而VCS（"type": "vcs"）只响应require里明确写出的Git URL或vendor/name + 分支/Tag组合。
最容易被忽略的一点：如果你同时配置了Path和VCS指向同一个包名（比如都叫my-company/utils），Composer会优先走Path源——前提是Path项在repositories里排得比VCS靠前。但如果VCS排第一，而你又没打Tag，它可能 fallback 到commit hash，导致Path完全被绕过。
- VCS源对
dev-main的支持取决于Git服务器是否返回refs/heads/main；Path源则直接读取本地git rev-parse HEAD - Path源无法被
composer show列出，除非你加--all参数；VCS源可以 - 别在Path源里放未初始化Git仓库的目录——Composer会静默跳过，不报错也不提示
为什么composer update有时不更新Path包
因为Composer把Path包当作“开发态快照”，默认不主动刷新。它只在composer install或composer update vendor/name时检查本地目录变更，并重新计算reference哈希值。
这导致一个隐蔽问题：你在./packages/utils里改了代码，但composer update没反应，vendor/my-company/utils还是旧的——不是缓存没清，是根本没触发重解析。
- 强制刷新：运行
composer update my-company/utils --with-dependencies，或删掉vendor/my-company/utils再composer install - Path包的
autoload映射必须在它自己的composer.json里定义，父项目autoload字段对其无效 - 如果Path包依赖了另一个Path包，两个都必须在
repositories里声明，且顺序不能颠倒（被依赖的必须在前）
