最常见原因是composer缓存了旧包信息或packagist未被禁用，导致忽略path仓库；需确保repositories中path配置正确、name完全匹配、路径合法，并显式禁用packagist.org或置顶path仓库。
为什么 composer require 会忽略本地 path 仓库配置
最常见的情况是：你已经在 composer.json 的 repositories 里加了 "type": "path"，但运行 composer require vendor/package 时，Composer 仍从 Packagist 拉取远程版本，而不是走你配的本地路径。
根本原因在于：Composer 默认只对「尚未安装」的包才查 repositories 列表；而如果你之前装过该包（哪怕只是试过），它的信息可能已缓存在 vendor/composer/installed.json 或全局 Composer cache 中，导致后续操作跳过仓库解析逻辑。
- 先删掉
vendor/和composer.lock（不删 lock 文件，Composer 可能沿用旧约束） - 确认
repositories块在根项目composer.json中，且位置在require之前（顺序无关，但放前面更易维护） -
path类型仓库的url必须是**绝对路径**或以./、../开头的相对路径；不能是~/或未展开的 shell 变量 - 目标目录下必须有合法的
composer.json，且其中name字段需与你require的包名完全一致（包括大小写）
如何让 Composer 优先使用本地 path 仓库而非 Packagist
Composer 对仓库的匹配是「按列表顺序 + 包名精确匹配」，不是「优先级高低」。它不会自动降级到下一个仓库——只要某个仓库声明了该包名，就用那个仓库的信息。
所以关键不是“覆盖”，而是“排他”：确保 Packagist 根本没机会响应这个包名请求。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把
path仓库配置放在repositories数组的第一个位置 - 在
path仓库的options中加上"packagist.org": false（Composer 2.2+ 支持），彻底屏蔽 Packagist 对该仓库中所有包的兜底行为 - 如果依赖链中其他包也声明了同名包（比如通过
replace或provide），它们不会触发path仓库；此时需检查composer show -s输出，确认实际解析到的是哪个 dist / source - 运行
composer require vendor/package:dev-main显式指定开发分支，避免因 Packagist 上存在1.0.0稳定版而自动选它（path仓库默认只暴露dev-前缀的版本）
path 仓库下 composer.json 的版本字段怎么写才有效
Composer 不读取 path 包的 version 字段，它会自动生成一个基于当前 Git HEAD 的开发版本号（如 dev-main 或 dev-master）。但如果你希望在主项目中稳定引用某个“逻辑版本”，就得靠 branch-alias 或标签。
- 不要写
"version": "1.2.3"—— 它会被忽略，还可能干扰 IDE 的依赖分析 - 在
path包的composer.json中设置"extra": {"branch-alias": {"dev-main": "1.2.x-dev"}}，这样主项目就能用"vendor/package": "^1.2"安装 - 如果本地包有 Git 标签（如
v1.2.3），Composer 会自动识别为1.2.3版本，前提是标签格式符合 SemVer 且已git push --tags - 修改
path包代码后，必须运行composer update vendor/package（不能只composer install），否则 vendor 中的 symlink 不会更新到最新 commit
切换后遇到 “Package not found” 或 “Could not find package” 错误
这类报错几乎都源于路径解析失败，而不是网络或权限问题。Composer 在 debug 模式下（-v）会打印出它尝试查找的具体路径，这是第一手线索。
- 运行
composer require vendor/package -v，看输出中是否出现类似Reading .../your/local/path/composer.json—— 如果没出现，说明路径没被加载 - 检查
url值是否拼错，尤其注意 Windows 下反斜杠要换成正斜杠/或双反斜杠\，否则 JSON 解析失败 - 确认目标目录存在且可读，Composer 不校验目录是否为空，但若里面没有
composer.json，就会静默跳过该仓库 - 如果你用的是符号链接（symlink）指向目标目录，请确保
path配置中写的是**真实路径**，不是 symlink 路径；Composer 不跟随 symlink 解析composer.json
真正麻烦的从来不是配置本身，而是 Composer 缓存和路径解析的隐式行为——它不会告诉你“我跳过了这个仓库”，只会安静地用 Packagist 替代。每次怀疑没生效，就删 lock、清 vendor、加 -v，三步下来基本定位到根因。
