Composer找不到自建包？配置私有仓库与中文镜像【核心】-composer-PHP中文网

因为composer search查的是packagist全局索引，而composer require只按项目composer.json中生效的repositories配置拉取；若repositories未正确配置为顶层字段、type拼写错误、私有源未置顶或未显式禁用并重加packagist.org，composer便根本不去指定路径查找，导致“package not found”。

composer找不到自建包？配置私有仓库与中文镜像【核心】

为什么`composer require`找不到自建包，但`composer search`能搜到

因为composer search查的是 Packagist 全局索引，而composer require实际安装时只按项目composer.json里生效的repositories配置去拉取——如果没配、配错位置、或被覆盖，它根本不会访问你的本地路径或私有 Git 仓库。

常见错误现象：Could not find package vendor/name at any version，本质不是网络不通，而是 Composer 压根没尝试去你指定的地址找。

repositories必须是项目根目录composer.json的顶层字段，和require、autoload平级；塞进config或extra里等于没写
type只接受四个值："composer"、"vcs"、"package"、"path"，拼错（如"git"、"github"）会触发Unrecognized repository type
私有源必须放在repositories数组最前面，否则可能被后面的镜像或packagist.org抢先匹配并终止查找

`repositories`写了却连`monolog/monolog`都装不上

这是最隐蔽也最高频的坑：只要你在repositories里声明了任意一条记录（哪怕只加了一个path），Composer 就会默认关闭packagist.org自动注入——结果是你自己的包没拉到，公共包也全挂了。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

修复方式不是删掉私有配置，而是显式补上官方源，并关闭自动注入：

第一项必须是{"packagist": false}，且必须是数组第一条，否则无效
第二项起手动加{"type": "composer", "url": "https://packagist.org"}（国内镜像请换为https://mirrors.aliyun.com/composer等）
私有 Git 仓库单独加一条，如{"type": "vcs", "url": "https://gitlab.internal.company.com/group/pkg"}
改完立刻执行composer clear-cache，否则旧缓存仍用“无 packagist”的配置

中文输入法、全角字符、大小写混入导致包名解析失败

Composer 不做模糊匹配，也不自动纠正。输错一个字符、斜杠方向反了、漏 vendor 名，或者命令行里混入全角空格/／，都会直接报Could not find package，错误提示却未必指向拼写问题。

包名必须全小写 vendor 名，package 名严格按 Packagist 上注册的来（如spatie/laravel-backup不能简写成spatie/backup）
别从网页或聊天记录里直接复制包名——里面可能藏不可见空格或全角字符；建议在纯文本编辑器里重打一遍再粘贴
Linux/macOS 下验证 Git 地址是否可访问：git ls-remote --heads https://github.com/myorg/my-private-package main
运行composer show -a vendor/name，输出为空就说明包名根本没被识别，先别急着调 stability

用了国内镜像却找不到刚发布的包或 dev 分支

阿里云、腾讯云等镜像不是实时同步，新 tag、dev 分支、或刚提交 Packagist 的包，通常延迟 5–30 分钟，高峰期可达数小时。你看到网页上有 v3.2.0，但composer show返回空，大概率就是这个原因。

验证镜像是否同步到位：curl -I https://mirrors.aliyun.com/composer/p/vendor/name.json，看响应头Last-Modified是否接近当前时间
composer clear-cache只清 ZIP 和部分 JSON，不碰关键元数据；真正有效的是删元数据缓存：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer
临时切回官方源验证：composer config --unset repos.packagist && composer clear-cache && composer show vendor/name
若确认是镜像延迟，不要反复clear-cache，等同步完成或换源