composer怎么让require命令支持本地源？

composer require 默认不走本地源是因为它优先查询 packagist.org，且仅当包名被某仓库显式声明支持时才查自定义源；需通过禁用 packagist、正确配置 path 仓库并指定版本约束，或使用 –repository-url 参数强制指定源。

composer require 为什么默认不走本地源

因为 composer require 默认只查 packagist.org，哪怕你已经配了 repositories，它也不会自动 fallback 到本地源——除非你明确告诉它“这个包就该从这儿装”。Composer 不会主动扫描所有仓库找匹配包，它按顺序查：先看 packagist.org（如果没关），再看自定义仓库，但前提是包名能被某个仓库“声明支持”。

怎么让 require 命令实际走本地源

核心是让 Composer 知道“这个包存在且只在本地源”，而不是去远程找。有三个可靠做法：

• 在 composer.json 的 repositories 里把本地源设为 packagist 类型并关闭官方源："packagist.org": false
• 用 path 类型仓库时，确保路径下有合法的 composer.json，且 name 字段和你要 require 的完全一致（比如 "myorg/mylib"）
• 执行 composer require myorg/mylib:dev-main 时，必须带版本约束（哪怕只是 dev-main），否则 Composer 仍可能去 packagist 查 latest stable

本地 path 仓库常见报错和修复

最典型的是：Could not find package myorg/mylib at any version，或者装完发现用的还是 packagist 上的老版本。原因往往不是配置错，而是：

• repositories 放在了项目级 composer.json 里，但没加 "type": "path" 和 "url": "./packages/mylib"（路径必须是相对当前 composer.json 的）
• 本地包的 composer.json 缺少 version 字段，或用了 dev-main 却没启用 "minimum-stability": "dev"
• 运行 composer require 前没清缓存：composer clear-cache，尤其换过仓库配置后

require 时指定仓库优先级的硬招

如果你只想对某一个包强制走本地源，又不想关掉 packagist，可以用 --repository-url 参数直连：

composer require myorg/mylib:dev-main --repository-url='{"type":"path","url":"./packages/mylib"}'

注意：--repository-url 接收的是 JSON 字符串，不是路径；单引号包裹防止 shell 解析错误；它会临时覆盖所有其他仓库，只用这一个。

这种写法绕过了 repositories 配置，适合 CI 或临时验证，但别写进脚本长期用——JSON 容易出引号嵌套问题，也难维护。

真正麻烦的不是配仓库，而是本地包的 autoload 和依赖解析是否干净。一旦本地包引用了外部包又没锁版本，require 过程可能突然切回 packagist 下载，而且不会警告。