必须配 repositories,否则require dev-main必失败;需在主项目composer.json根级声明path类型仓库,url用相对路径,本地包name和version须严格匹配dev-main,且须设minimum-stability为dev。

require 里写 dev-main 前必须配 repositories
不配 repositories,composer require my-vendor/my-package:dev-main 一定失败,报 Could not find package。Composer 默认只查 Packagist,根本不会扫描你硬盘上的文件夹。
必须在项目根目录 composer.json 的顶层加这个块:
{
"repositories": [
{
"type": "path",
"url": "./packages/my-local-package"
}
]
}
注意:url 是相对路径(推荐),不能以 ./ 开头的写法在某些旧版 Composer 会被忽略;也不能是 file:// 或环境变量路径;Windows 下若用绝对路径,得带盘符(如 C:/work/my-package)。
dev-main 不是万能通配符,它严格依赖本地包的分支名或 version 字段
Composer 查 dev-main 时,实际行为分两种:
- 如果本地包目录已初始化 Git,且存在
main分支,Composer 就按该分支 HEAD 的代码装 - 如果没 Git 或没
main分支,但本地包composer.json里写了"version": "dev-main",那也会匹配上
常见翻车点:
- 本地包只有
master分支,却 requiredev-main→ 报错Could not find a matching version - 本地包
composer.json的name是acme/utils,但 require 写成Acme/utils→ 大小写敏感,不匹配 - 本地包目录下没有
composer.json,或缺name字段 → 静默跳过,不报错也不提示
别在 require 里混用语义化版本符和 dev-main
^1.2.0、~1.2、=1.2.3 这些对 path 类型仓库完全无效。它们不会触发错误,但会误导人——Composer 实际仍读本地包里的 version 字段,而忽略你写的约束。
正确写法只有一种:
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
"require": {
"my-vendor/my-package": "dev-main"
}
为什么不用 *?虽然 "*" 语法合法,但它不显式表达意图,后续维护者看不出你是在调试开发版;而且一旦你忘了设 "minimum-stability": "dev",* 会 fallback 到 stable 源并失败。
务必在项目 composer.json 顶层加上:
"minimum-stability": "dev", "prefer-stable": true
否则 dev-main 会被稳定性策略直接过滤掉。
改了本地包代码,vendor 里不会自动同步
默认行为是「拷贝」:Composer 把整个本地包目录复制进 vendor/。你改了 ./packages/my-local-package/src/,vendor/my-vendor/my-package/src/ 仍是旧内容。
两个解决方向:
- 启用软链:在
repositories条目里加"options": {"symlink": true},这样改源码立刻生效 - 手动刷新:改完本地代码后运行
composer update my-vendor/my-package --with-dependencies,强制重拉并重建 autoload
注意:软链模式下,vendor/ 里只是符号链接,CI 构建或部署时可能因权限或路径问题失败;拷贝模式更“干净”,但调试效率低。选哪个,取决于你当前阶段更看重实时性还是可移植性。










