先确认包名拼写和仓库配置是否正确；运行 composer show -p 查看已配置仓库，检查 repositories 中 URL 协议、大小写、type 与 url 是否匹配；设置 minimum-stability 或 --stability=dev 以支持 dev 分支；确保 Git 包含正确 composer.json；更新源后需删除 vendor 和 composer.lock 再 install。
Composer install 报错 Package not found 怎么定位
不是包名拼错了就是源没配对。Composer 默认只查 packagist.org，但很多私有包、dev 分支、本地路径包根本不在上面。
- 先运行
composer show -p看当前已配置的仓库列表，确认有没有漏掉私有源或packagist.org被意外禁用 - 检查
composer.json里repositories字段是否写错 URL，比如把https://写成http://（某些私有源会拒绝非 HTTPS 请求） - 如果包名带 vendor 名（如
myorg/my-package），确认大小写完全一致——Linux 下大小写敏感，Windows 有时“碰巧”能过，但上线就炸
用了 repositories 还是找不到包？注意 type 和 url 的匹配关系
type 决定 Composer 怎么解析那个 URL，填错 type 就等于告诉 Composer “请用 FTP 协议去读一个 Git 仓库”，它当然读不出来。
-
"type": "composer"：对应一个支持packages.json的 Composer 仓库（比如 Satis、Private Packagist），url 必须指向含该文件的根路径，比如https://repo.mycompany.com/ -
"type": "vcs"：对应 Git/Svn/Hg 仓库，url 必须是可 clone 的地址，比如https://gitlab.com/mygroup/mylib.git；不能是网页链接（如https://gitlab.com/mygroup/mylib） -
"type": "package"：适合单个包的硬编码定义，但必须手动写全name、version、dist或source，漏一项就加载失败
composer require 时提示 Could not find package xxx at any version
常见于包只在特定分支、Tag 或开发版本存在，而 Composer 默认只找 stable 版本。
- 加
--stability=dev或在composer.json里设"minimum-stability": "dev"，否则像v2.0.x-dev这种分支名直接被过滤 - 用
composer show xxx/yyy查包是否存在、有哪些可用版本；如果返回空，说明包名或源配置仍有问题 - 如果是 Git 包，确保目标分支有
composer.json且name字段和 require 的完全一致（包括 vendor 部分）
私有 Git 包拉不下来，Authentication failed 或超时
Composer 走的是命令行 Git，不是你 IDE 里登过的账号，它不会自动复用 SSH key 或 Git 凭据管理器的 token。
- 用 SSH 地址（
git@gitlab.com:xxx/yyy.git）前，先终端里ssh -T git@gitlab.com测试通不通 - 用 HTTPS 地址（
https://gitlab.com/xxx/yyy.git）时，得配 Git 凭据：运行git config --global credential.helper store，然后第一次 clone 时输一次账号密码，后续才免密 - 公司内网 GitLab 常被防火墙拦截，试试加
"options": {"http": {"timeout": 600}}到repositories条目里
最常被忽略的是：改了 repositories 后没删 vendor 和 composer.lock 就直接 install——Composer 会优先按 lock 文件里的旧记录装，根本不会重新查源。
