Composer path仓库require失败主因是name或路径不匹配：name须大小写及短横线完全一致，url须为不含尾斜杠的合法绝对或相对路径，且指向含有效composer.json的目录。

path仓库配置后require失败，先确认name和路径是否完全匹配

Composer 对 path 类型仓库的 name 和 url 是严格字面匹配的，大小写、分隔符（只认短横线 -）、斜杠方向、末尾是否带 / 全部算在内。比如你在主项目 composer.json 的 repositories 里写了："url": "../my-pkg/"，它就会静默忽略整个仓库——因为末尾的 / 导致路径解析失败。

实操建议：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 用 ls -ld ../my-pkg（Linux/macOS）或 dir ..my-pkg（Windows CMD）确认该目录真实存在，且是相对于主项目 composer.json 的位置
• 打开本地包根目录下的 composer.json，检查 name 字段值（如 "acme/utils"），必须和主项目 require 中写的完全一致，不能是 "Acme/utils" 或 "acme_utils"
• 确保本地包 composer.json 语法合法：无尾逗号、全双引号、JSON 格式有效（可用 php -l composer.json 快速验证）

symlink没生效？检查本地包自己的options配置

path 仓库默认尝试创建符号链接，但失败时会静默 fallback 到复制（copy）模式。你改了本地源码，vendor 里还是旧副本，根本原因不是主项目配错了，而是本地包自己的 composer.json 缺了 "options": {"symlink": true}。

实操建议：

• 在本地包（即 url 指向的那个目录）的 composer.json 根对象里，显式加上 "options": {"symlink": true}
• Windows 用户必须以管理员身份运行终端；Docker 容器需加 --cap-add=SYS_ADMIN 并挂载宿主机目录（非 volume）
• 验证是否真用了 symlink：ls -la vendor/acme/utils（Linux/macOS）看到箭头指向源目录才算成功；Windows 用 dir vendorcmeutils 看是否为 JUNCTION

autoload不生效，不是没装上，而是映射没更新

即使 composer show acme/utils --path 能正确输出路径，new AcmeUtilsHelper() 仍报 Class not found，大概率是 autoload 映射没包含本地包的真实路径。

实操建议：

• 确认本地包 composer.json 中有合法的 autoload 声明，例如："psr-4": {"Acme\": "src/"}
• 主项目执行 composer dump-autoload -o（注意加 -o，否则优化 autoload_static.php 不会重生成）
• 别依赖 IDE 自动索引——某些 IDE 会缓存旧路径，重启 IDE 或手动刷新索引
• 检查 Web 入口文件中 require 的是不是新 vendor 下的 autoload.php，路径错一个字符就全崩

为什么 composer depends acme/utils 查不到？它根本不查未安装项

composer depends 只扫描当前项目已安装进 vendor/ 的包，以及 composer.lock 中记录的依赖关系。如果你刚配好 path 仓库但还没运行 composer install 或 composer require acme/utils，它就什么也查不到。

实操建议：

• 先确保本地包已通过 composer install 成功落地到 vendor/acme/utils（用 composer show acme/utils --path 验证）
• 若只在 require-dev 里，加 --link-type=require-dev 才能查到
• 想跨项目查谁用了它？别指望原生命令——直接 grep -r '"acme/utils"' /path/to/projects/ --include="composer.json"

最常被跳过的一步：改完本地包代码后，忘了在主项目里跑 composer dump-autoload -o。autoload_static.php 不更新，类就永远找不到。