Composer不支持require时直接起别名，需通过repositories.package手动定义：指定name为别名、version精确匹配、dist.url指向归档包，并完整配置autoload规则。
composer require 时如何给包起别名
Composer 本身不支持在 require 命令中直接指定别名（比如 composer require vendor/pkg as my-alias 这种语法是无效的）。别名必须通过 repositories + package 类型手动定义，且仅适用于「替换包」或「重映射包路径」的场景，不是为日常依赖起昵称用的。
- 别名本质是让 Composer 把某个包名（如
monolog/monolog）当作另一个名字（如my/logger）来解析和加载 - 它只在
autoload和类名解析层面生效，不影响实际安装的源、版本或文件结构 - 常见于私有包迁移、fork 替换、或统一内部命名规范（例如把多个团队包都 alias 到
company/*下）
用 repositories.package 定义别名的正确写法
在 composer.json 中添加 repositories，类型设为 package，并显式声明 name（目标别名）和 source（真实来源）：
{
"repositories": [
{
"type": "package",
"package": {
"name": "my/logger",
"version": "3.0.0",
"dist": {
"url": "https://github.com/Seldaek/monolog/archive/refs/tags/3.0.0.zip",
"type": "zip"
},
"autoload": {
"psr-4": {
"Monolog\\": "src/"
}
}
}
}
],
"require": {
"my/logger": "^3.0"
}
}
-
name字段就是你要的“别名”，必须符合 Composer 包名规范（小写字母、短横线、斜杠） -
version必须精确匹配，不能写^3.0——package类型不支持版本约束推导 -
dist.url要指向可下载的归档包（zip/tar），不是 Git 仓库地址；若用vcs类型则无法 alias - 执行
composer update my/logger后，该包会以my/logger名字出现在vendor/下（实际目录仍是vendor/my/logger，但内容来自 Monolog）
别名后类自动加载为什么可能失效
别名不会自动继承原包的 autoload 配置。你必须在 package 定义里完整复制或重写 autoload 规则，否则 class not found 错误必然出现。
- 如果原包用 PSR-4，你就得照抄
"Monolog\\": "src/"，不能省略或写错命名空间前缀 - 别名包的命名空间与包名无关——
my/logger的代码仍可以声明namespace Monolog;，只要 autoload 映射对就行 - 运行
composer dump-autoload后检查vendor/composer/autoload_psr4.php，确认你的别名对应关系已写入
alias 和 replace 的关键区别
replace 是声明“我这个包替代了另一个包”，用于冲突解决或 fork 替换；而 alias 是“我用另一个名字引用同一个包”。两者目的不同，配置位置也不同：
-
replace写在被 require 的那个包自己的composer.json里（即你 fork 的 monolog 的 composer.json 中加"replace": {"monolog/monolog": "self.version"}） -
alias只能通过repositories.package在当前项目中实现，没有其他方式 - 别名不能跨项目复用——每个要用别名的项目都得单独配
repositories
真正需要 alias 的场景极少，多数时候想“起个好记的名字”只是误解了 Composer 的设计意图；优先考虑用清晰的包名、文档或脚本封装，而不是绕过包管理机制硬加一层映射。
