composer 支持用 as 语法将分支（如 dev-main）映射为合法 semver 版本号（如 1.5.0），格式为 vendor/package:dev-main as 1.5.0，需确保 composer.json 中正确写入 "1.5.0 as dev-main" 并执行 composer update。
composer require 怎么把分支映射成版本号
Composer 默认不认 dev-main 或 dev-feature/x 这种分支名作为合法版本，但你可以用 as 语法强行把它“伪装”成一个稳定版本号来安装。这不是 hack，是 Composer 官方支持的别名机制。
核心逻辑：告诉 Composer “这个分支，我当它是 1.2.3 用”，后续依赖解析、更新、锁定都按这个假版本走。
- 必须写全分支前缀：
dev-不能省，比如dev-main、dev-develop -
as后面只能是符合 SemVer 的版本字符串（如1.0.0），不能是latest或stable - 别名只影响当前包的版本解析，不影响源仓库的 Git 状态
示例：
composer require vendor/package:dev-main as 1.5.0
为什么 require dev-xxx as X.X.X 后 composer install 还报错
常见错误是 Your requirements could not be resolved to an installable set of packages —— 表面看是别名没生效，实际多半是依赖冲突或别名没进 composer.json 锁定。
- 执行
composer require后，检查composer.json里对应包的版本字段是否已变成"1.5.0 as dev-main"（注意引号和空格） - 如果手动改过
composer.json但没运行composer update vendor/package，别名不会被加载 - 某些旧版 Composer（as 解析有 bug，升级到
composer self-update最新版再试 - 别名版本不能和项目中其他依赖要求的同一包版本冲突，比如已有
"vendor/package": "^1.4"，你又 require"dev-main as 2.0.0"，就会冲突
别名在 composer.lock 里长什么样
别名不是“欺骗 lock 文件”，而是直接参与版本计算。一旦写入，composer.lock 会明确记录真实 commit hash 和你指定的别名版本。
打开 composer.lock 搜索你的包名，你会看到类似：
"packages": [
{
"name": "vendor/package",
"version": "1.5.0",
"source": {
"type": "git",
"url": "https://github.com/vendor/package.git",
"reference": "a1b2c3d4..."
},
"dist": { ... },
"aliases": [
"dev-main"
]
}
]
注意：version 字段存的是你 as 的值（1.5.0），aliases 数组存的是原始分支名（dev-main）。这是 Composer 内部做依赖比对的关键依据。
- 删掉
composer.lock后重装，别名依然有效 —— 只要composer.json里还写着"1.5.0 as dev-main" - 如果别人 clone 你的项目并运行
composer install，只要 lock 文件存在，就完全不需要知道原始分支名
别名 vs repositories type=package 的区别
有人会想到用 repositories + package 类型手动定义包，也能绕过分支限制。但这是两回事：
-
as是轻量映射，不改源、不加 repo 配置，适合临时测试或内部分支集成 -
repositories.type=package是彻底接管包定义，要自己写version、dist、autoload等，维护成本高，且无法自动更新 commit - 别名能用
composer update vendor/package拉最新 commit；而package类型除非你手动改 reference，否则永远固定在某个 commit - 如果你只是想让 CI 测试某个 PR 分支，
require dev-fix/auth as 1.0.0@dev就够了，别去碰 repositories
别名真正容易被忽略的点：它只在 require 时起作用。如果你已经通过其他方式（比如 fork 后改 name）引入了同名包，Composer 会优先用已声明的 source，as 可能被静默忽略 —— 此时得先 composer remove vendor/package 再重新 require。
