Composer 找不到指定版本通常因版本约束与 Packagist 实际发布版本不匹配，如忽略后缀（-beta）、分支别名（dev-main）或未配置 minimum-stability；需用 composer show 查可用版本，显式声明稳定性（如 @dev）或修正包名、缓存、语法。
Composer 找不到指定版本，绝大多数情况不是包真不存在，而是你写的版本约束和 Packagist 上实际发布的版本号不匹配——尤其是带后缀（如 -dev、-beta、-patch）或含分支别名（dev-main）时，匹配规则会严格到令人意外。
为什么 composer require vendor/package:1.2.3 报错“could not find package”？
这通常不是网络或源的问题，而是 Packagist 根本没收录这个精确版本。Composer 默认只信任已发布（tagged）的稳定版本，除非你显式允许不稳定类型。
- 检查真实可用版本：
composer show vendor/package（不加版本号），看输出里列出的versions列表 - 如果目标版本是
1.2.3-beta.1，但你写的是1.2.3，Composer 不会自动降级匹配 - 如果包只发布了
dev-main分支，而你写^1.2，默认策略下 Composer 不会拉取开发分支 - 私有包未配置正确仓库（
repositories）也会触发同样错误，但报错信息一模一样，容易误判
如何让 Composer 接受 -dev 或 -alpha 这类不稳定版本？
必须显式声明最低稳定性要求，并确保版本约束本身能命中目标。仅靠改 minimum-stability 不够，还要配合 prefer-stable 和具体版本写法。
- 在
composer.json中设置："minimum-stability": "dev",<br>"prefer-stable": true
- 但更推荐按需指定：直接写带稳定性的版本约束，例如
"vendor/package": "dev-main as 1.2.3"或"dev-develop#abc123" - 使用
@dev后缀是最简方式：composer require vendor/package:dev-main@dev，它绕过稳定性检查，但仅限该条目 - 注意：
minimum-stability是项目级全局设置，会影响所有包，上线前务必改回stable
composer require 时提示 “no matching package found”，但包明明存在？
常见于包名拼写错误、大小写不一致（Linux 环境敏感）、或用了非标准命名空间（比如 GitHub 用户名写错）。Packagist 不做模糊匹配，错一个字符就失败。
- 确认包名完全一致：访问
https://packagist.org/packages/vendor/package，复制 URL 末尾的全名 - 检查是否启用了私有源但未正确配置
repositories，导致 Composer 只查了 packagist.org - 运行
composer clear-cache再试——缓存可能残留旧的元数据（尤其切换过源之后） - 如果用的是 Git URL 方式引入（
git@github.com:xxx/yyy.git），确保 SSH key 已配置且 GitHub 账户有权限
最易被忽略的一点：Composer 的版本解析器对空格、引号、波浪线（~）和插入符（^）极其敏感。写 "^1.2.3 "（末尾多一个空格）或 '^1.2.3'（单引号在某些 shell 下会被截断），都可能导致解析失败且报错信息毫无提示。手动编辑 composer.json 后，务必用 composer validate 检查语法。
