path仓库必须用绝对路径，相对路径会静默失效；composer不解析相对路径，会在项目根目录查找导致跳过仓库；正确做法是使用完整绝对路径，避免环境变量或波浪号；符号链接权限、vendor目录权限及repositories顺序也影响生效。
path仓库必须用绝对路径，相对路径会静默失效
Composer 的 path 类型仓库不解析相对路径（如 "../my-package" 或 "./local-lib"），它会在当前项目根目录下查找该路径，而非从 composer.json 所在位置出发解析。结果就是：路径找不到 → Composer 跳过该仓库 → 报错 Could not find package vendor/name，但不会提示“路径无效”。
正确做法是把 url 值写成完整绝对路径：
- Linux/macOS：
/home/username/projects/my-package或/Users/username/dev/my-package - Windows：
C:/Users/username/dev/my-package（正斜杠或反斜杠均可，推荐正斜杠） - 避免使用环境变量或波浪号：
$HOME/my-package和~/my-package都不会被展开，会被当作字面字符串处理
为什么 composer dump-autoload 不生效？检查 vendor 目录权限和符号链接
即使路径写对了，composer install 或 composer update 仍可能跳过 path 仓库，常见原因是：vendor 目录不可写，或目标包目录里没有有效的 composer.json（比如漏了 name 字段）。
更隐蔽的问题是符号链接（symlink）权限限制：
- 某些系统（如 macOS Catalina+、WSL2 默认配置）禁止跨文件系统创建符号链接，而 Composer 对
path仓库的实现依赖 symlink - 运行
ls -l vendor/vendor-name/package-name，如果看到broken symlink或指向不存在路径，说明链接失败 - 临时解决：在项目根目录执行
composer config --global prefer-stable true并重试；长期方案是确保源目录与项目在同一挂载点，或改用vcs类型 + 本地 Git 仓库
多个 path 仓库共存时，顺序决定优先级
repositories 数组中靠前的 path 仓库会优先生效。如果两个仓库都声明了同一个包名（如 "myorg/utils"），Composer 只取第一个匹配项，后面的完全忽略——不会合并、不会 fallback。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型误配：
{
"repositories": [
{ "type": "path", "url": "/tmp/utils-dev" },
{ "type": "path", "url": "/home/me/libs/utils" }
],
"require": { "myorg/utils": "*" }
}
上面配置中，哪怕 /tmp/utils-dev 里没有 composer.json 或 name 不匹配，Composer 也不会继续查第二个路径。必须保证第一个路径下有合法包定义，否则直接报错。
验证 path 仓库是否真正加载
最直接的方式不是看 composer install 是否成功，而是检查 vendor 下生成的是真实目录还是符号链接：
- 成功时：
ls -l vendor/myorg/utils显示类似myorg/utils -> /absolute/path/to/source - 失败时：
ls -l vendor/myorg/utils报No such file or directory，或显示一个空目录（说明 Composer 回退到 Packagist 下载了别的版本） - 辅助命令：
composer show myorg/utils输出中的source行应为type : path，且url是你配置的绝对路径
注意：path 仓库只在 install 和 update 时参与解析，require 命令本身不触发仓库重载，所以加完仓库后务必运行 composer update myorg/utils 或全量 composer update。
