“Package not found”主因是源未生效、稳定性过滤或元数据不匹配；需检查repositories位置与格式、minimum-stability设置、包名全匹配，并用-vvv验证实际访问源。
“Package not found”不是网络问题，也不是权限问题，而是 Composer 根本没去你认为它该去的地方找包——要么源没生效、要么元数据过期、要么包名在当前约束下被直接过滤掉了。
为什么 composer require 找不到包，但 composer search 能搜到
composer search 只查 Packagist 全局索引，不看你的 composer.json 里写的 minimum-stability、prefer-stable，也不管你配了哪些 repositories；而 require 是真安装，会严格按配置顺序、稳定性策略、已锁依赖版本三重过滤。
- 项目设了
"minimum-stability": "stable"，但你要装的包只有dev-main版本 → 直接跳过，报 “not found” -
composer.json里已有monolog/monolog: "^2.8"，而新包要求monolog/monolog: "^3.0"→ 依赖冲突被误报为 “not found” - 用了
-w（--with-dependencies）参数，强制合并整个依赖树，稍有不兼容就放弃安装
检查镜像是否真在用，以及元数据是否过期
很多人改完阿里云镜像就跑命令，日志里却还是出现 Downloading https://packagist.org/——说明配置根本没生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repos.packagist（注意是复数repos），输出必须是完整 JSON，比如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"} - 项目根目录若有
composer.json且含"repositories"字段（哪怕只是空数组[]），就会**完全屏蔽全局镜像**；此时要查composer config repo.packagist（不加-g） - 执行
composer update --refresh强制重载远程packages.json，否则 Composer 默认复用 15 分钟内缓存的元数据 - 临时切回官方源验证：
composer config --global repo.packagist composer https://packagist.org，再跑composer require vendor/name -vvv
私有包或 VCS 仓库始终 404 的硬性条件
VCS 类型仓库（Git/GitLab）不会出现在 Packagist 索引里，composer search 永远搜不到；require 时若失败，90% 是配置没写对位置或格式错。
-
repositories数组中必须包含独立项{"packagist.org": false}，且放在**末尾**；写成"packagist": false或嵌套在其他对象里会被静默忽略 - VCS 仓库
type必须是"vcs"，不能写"git"或漏掉；url必须是可git clone的地址，且结尾只能是.git，不能带分支或路径（如#main或/tree/main） - 目标 Git 仓库根目录下必须有合法
composer.json，其中"name"字段必须和require命令里写的**完全一致**（包括大小写） - 别信
composer clear-cache能解决一切——它不删元数据缓存；真要清，得手动删~/.composer/cache/repo/https---mirrors-aliyun-com-composer
什么时候能用 --ignore-platform-reqs，什么时候不能
这个参数只跳过 PHP 版本、扩展等平台检查，**对 “package not found” 几乎无效**。它解决的是 platform requirements mismatch，不是包找不到。
- 如果报错是
Could not find package，加--ignore-platform-reqs不会改变结果 - 如果报错是
Your requirements could not be resolved且带ext-redis、php: ^8.1等字样，才考虑它 - 只忽略具体缺失项：
--ignore-platform-reqs=ext-gd,ext-mbstring；不带值 = 忽略全部，风险极高 - 更安全的做法是：先运行
composer update --lock尝试仅更新锁文件，避免全量升级引入不兼容
最常被忽略的一点：错误信息里写的是 “Package not found”，但实际原因可能是 “Version not satisfiable” 或 “Source not consulted”。别被字面意思带偏，先看 -vvv 日志里到底访问了哪个 URL、读了哪份 packages.json、是否命中了你配的私有源——这才是定位根因的关键。
