如何使用 Composer 安装一个不发布在 Packagist 上的 Git 仓库？

可直接在composer.json中添加VCS类型私有仓库并安装包。需设"type": "vcs"、填Git地址、确保包含合规composer.json；然后composer require vendor/name即可安装，支持标签（如1.2.3）或分支（如dev-main）版本。

可以直接在 composer.json 中添加自定义仓库并指定包的源，无需发布到 Packagist。

添加 VCS 类型仓库

Composer 支持通过 vcs 类型仓库拉取 Git 项目。在项目的 composer.json 的 repositories 字段中声明仓库地址：

• 仓库类型必须设为 "type": "vcs"
• "url" 填写 Git 仓库的 HTTPS 或 SSH 地址（如 https://github.com/username/repo.git）
• 确保该仓库有符合 Composer 规范的 composer.json 文件（含 name 和 version 或使用分支/标签作为版本）

安装指定仓库中的包

声明完仓库后，像安装普通包一样运行 composer require，使用该仓库中 composer.json 定义的 name：

• 例如仓库里 composer.json 写着 "name": "myorg/my-package"，就执行 composer require myorg/my-package
• Composer 会自动匹配最新稳定版（如 v1.0.0 标签），也可手动指定版本，如 dev-main、dev-develop 或 1.x-dev

注意版本与分支对应关系

Composer 默认把 Git 分支名映射为开发版本，标签映射为稳定版本：

• main 或 master 分支 → dev-main
• 1.2.3 标签 → 1.2.3（需符合语义化版本格式）
• 若想强制安装某分支，可在 require 时写明：composer require myorg/my-package:dev-main

可选：设置仓库优先级或禁用 Packagist

如果只想用私有仓库，避免意外命中 Packagist，可在 repositories 中加入空的 Packagist 配置来禁用默认源：

• ⚠️ 注意：加 {"type": "packagist", "url": false} 会完全关闭 Packagist
• 更安全的做法是把私有仓库放在 repositories 数组首位，Composer 会按顺序查找

基本上就这些。不复杂但容易忽略仓库类型和 name 匹配，确认好这几点就能顺利装上任意 Git 仓库里的包。