不加"minimum-stability": "dev"就无法拉取本地dev分支包，因Composer默认仅允许stable版本；需在项目根composer.json顶层配置"minimum-stability": "dev"和"prefer-stable": true，并运行composer update刷新lock文件。
不加 minimum-stability: dev 就根本拉不到本地 dev 分支
本地包通常用 dev-main、dev-master 这类分支名，而 Composer 默认只认 stable 版本。没配 minimum-stability 时，composer require acme/utils:dev-main 会直接报错：Could not find package acme/utils——不是路径问题，是稳定性过滤掉了。
解决方法是在项目根目录的 composer.json 顶层加两行：
"minimum-stability": "dev", "prefer-stable": true
这样既允许安装 dev- 前缀的版本，又不会把所有依赖都降级到 alpha/beta；prefer-stable 会让 Composer 在满足约束前提下优先选 stable 版本。
- 别只写
"minimum-stability": "dev"却漏掉prefer-stable，否则可能意外装进一堆不稳定依赖 - 改完必须运行
composer update（不是install），否则 lock 文件不更新，行为不变 - 这个配置只影响当前项目，不影响本地包自身的
composer.json
本地包里加 version 字段是临时 hack，上线前必须删
有人在本地包的 composer.json 里硬写 "version": "dev-main" 来绕过配置，这确实能让 composer require acme/utils 不写版本号就装上——但这是危险操作。
version 字段在本地开发时被 Composer 读取，但一旦发布到 Packagist，它会被忽略；更严重的是，如果同名包已存在正式版本，这个字段可能引发哈希冲突或同步失败。
- 仅限调试阶段使用，且必须配合
minimum-stability: dev - 上线前务必删除该字段，否则 CI/CD 流水线可能因校验失败中断
- 真正可靠的本地调试方式是配
repositories+path类型，而不是靠伪造 version
path 仓库模式下，minimum-stability 依然生效
即使你已经用 repositories 配了本地路径：
"repositories": [
{
"type": "path",
"url": "../acme-utils"
}
]
如果没设 minimum-stability，composer require acme/utils:dev-main 还是失败。因为 path 仓库只是告诉 Composer “源在哪”，不改变版本解析规则。
- 仍需顶层
minimum-stability: dev才能匹配dev-main这类标签 - 若本地包
composer.json中有"version": "1.0.0"，则可直接require acme/utils:1.0.0，无需改 stability - 注意：path 模式默认是拷贝而非软链，改代码后要
composer update才生效
为什么 composer install 不认本地修改？lock 文件锁死了来源
很多人以为改了 vendor 里的本地包代码就能调试，结果跑一遍 composer install 全被覆盖——这是因为 composer.lock 记录的是「下载源 + 哈希值」，跟你的本地文件无关。
真正让本地代码实时生效的方式，是启用 symlink：
"repositories": [
{
"type": "path",
"url": "../acme-utils",
"options": {
"symlink": true
}
}
]
这时 vendor/acme/utils 是个符号链接，指向你本地目录，改代码立刻可见。
- symlink 模式下，
minimum-stability仍需正确设置，否则require阶段就失败 - Windows 用户注意：需启用开发者模式或管理员权限才能创建 symlink
- CI 环境通常禁用 symlink，所以该配置不应提交到主干分支
实际调试中最容易被忽略的一点：你以为改了 minimum-stability 就万事大吉，但只要 composer.lock 里还锁着旧版本，composer install 就永远不走新逻辑。必须 composer update acme/utils 或至少 composer update --lock 刷新 lock 文件。
