Composer只接受相对于项目根目录的url路径，绝对路径（如/home/user/pkg或C:\dev\pkg）会被静默忽略或报错；必须用相对路径（如./packages/pkg），且repositories须置于根composer.json顶层。
不能用绝对路径安装本地包——Composer 会静默忽略，或直接报错。 它只接受相对于项目根目录的 url 值，硬写绝对路径（如 /home/user/my-package 或 C:\dev\my-package）会导致仓库被跳过、composer update 找不到包、甚至不提示任何错误。
为什么绝对路径在 repositories.path 中无效
Composer 的 path 类型仓库设计初衷是支持团队协作和可复现构建：路径必须可移植，不能绑定某台机器的文件系统结构。因此它强制要求 url 是相对路径（从项目 composer.json 所在目录出发计算）。一旦你写了绝对路径：
- Linux/macOS 下可能触发
Could not parse version constraint或no packages found - Windows 下常表现为“包名未识别”，但
composer diagnose不报错，排查极难 - 即使看似成功（比如用了
file://协议），autoload 也大概率失效，因为 Composer 内部对file://路径不启用符号链接逻辑
替代方案：用相对路径 + 符号链接模拟绝对路径效果
如果你的本地包确实在固定位置（比如统一放在 ~/packages/），又不想每次复制路径，可以用软链接把包“拉进”项目周边目录：
- 在项目根目录旁建一个
packages目录：ln -s ~/packages my-packages（macOS/Linux）或mklink /D my-packages "%USERPROFILE%\packages"（Windows） - 然后在
composer.json的repositories中写："url": "my-packages/my-local-package" - 确保
my-local-package目录下有合法composer.json，且name字段与require中完全一致
哪些地方看似能写绝对路径，实则危险
以下写法全部不可靠，应避免：
-
"url": "file:///home/user/my-package"—— 不触发 path 仓库的符号链接行为，类加载失败 -
"url": "/home/user/my-package"—— Composer 解析为无效 URI，静默跳过该仓库 -
"url": "~/my-package"——~不展开，等价于字面量~/my-package，找不到目录 - 把
repositories写在子目录的composer.json或extra字段里 —— Composer 根本不读
真正起作用的只有项目根目录 composer.json 顶层的 repositories 数组，且 url 必须是干净的相对路径。路径不对，后面 autoload、测试、CI 全都会断——这不是缓存问题，是配置根本没被加载。
