<p>Composer 安装 GitHub 插件需仓库含合规 composer.json（含合法 name 字段），否则报错；私有库需配置 repositories 为 vcs 类型并指定 URL；安装 dev 分支或 commit 需显式加 dev- 前缀版本约束；autoload 配置错误会导致 Class not found。</p>
Composer 可以直接安装 GitHub 上的插件，但不是所有仓库都“开箱即用”——关键看它是否符合 Composer 的包规范，尤其是 composer.json 是否存在且配置正确。
GitHub 仓库必须有合法的 composer.json
Composer 不是 Git 客户端，它不会自动识别任意 GitHub 项目为可安装包。它只认 composer.json 中声明的 name、version、autoload 等字段。
- 如果仓库根目录没有
composer.json，composer require username/repo会报错：Could not find a matching version of package username/repo - 即使有
composer.json，若缺少name（格式必须是vendor/name，如monolog/monolog），Composer 也无法将其注册为有效包 - 私有仓库或未打 tag 的开发版，需显式指定
dev-main或dev-develop作为版本约束，例如：composer require "username/repo:dev-main"
用 repositories 手动添加非 Packagist 仓库
当目标仓库不在 Packagist 上，或你希望绕过 Packagist 缓存直连 GitHub，就得在项目根目录的 composer.json 中声明自定义源：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/username/repo"
}
]
}
之后才能运行：composer require username/repo（前提是该仓库有合规的 composer.json）
-
"type": "vcs"是必须的，不能写成"git"或"github" - URL 必须是可被 Composer 克隆的地址（支持 HTTPS 和 SSH，但 SSH 需提前配好密钥）
- 如果仓库使用子目录作为实际包路径（比如源码在
/src），需配合composer/installers或自定义autoload，否则require进来后类可能无法自动加载
安装 dev 分支或特定 commit 要加版本约束
GitHub 上没打正式 tag 的代码，默认不被视为稳定版本，Composer 默认只装 stable 级别包。想装开发分支，必须显式指定不稳定版本标记：
- 装 main 分支：
composer require "username/repo:dev-main" - 装某次提交：
composer require "username/repo:dev-main#abc1234"（abc1234是 commit hash 前缀） - 临时禁用稳定性检查（不推荐）：
composer require username/repo --stability=dev --prefer-source - 注意：加了
dev-前缀后，Composer 会跳过版本解析缓存，每次都重新 fetch，CI 环境下可能变慢
最常被忽略的一点：就算 composer require 成功了，如果仓库的 autoload 没配对（比如 PSR-4 映射路径写错，或用了 files 但文件不存在），vendor/autoload.php 就不会加载它的类——这时候报 Class not found 跟网络或安装过程无关，纯属配置问题。
