“no matching package found”主因是本地元数据缓存未刷新、项目级repositories覆盖全局镜像或镜像url缺斜杠导致重定向；应curl验证镜像可达性、精准删除对应缓存子目录、检查项目composer.json中repositories字段是否静默禁用镜像。

镜像配置本身不能解决包缺失，它只加速已有包的下载；所谓“包缺失”，95% 是缓存未刷新、配置被覆盖或根本没走镜像导致的假性缺失。

composer show 报 “no matching package found” 怎么办

这不是镜像没同步，而是 Composer 死守本地缓存里的 packages.json 和 provider-vendor-package.json，哪怕镜像已更新，旧缓存仍让命令认为包不存在。

• 先验证镜像元数据是否可达：curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回 HTTP/2 200
• 再查具体包：curl -I https://mirrors.aliyun.com/composer/p/spatie/laravel-ray.json，看 Last-Modified 是否接近当前时间
• 别信 composer clear-cache —— 它不碰元数据缓存，真正要删的是：rm -rf ~/.composer/cache/repo/https---mirrors-aliyun-com-composer（Windows 路径为 %APPDATA%\Composer\cache\repo\https---mirrors-aliyun-com-composer）
• 删完立刻跑 composer update --dry-run -v，日志里出现 Downloading https:// 才算生效

项目级 repositories 字段静默禁用全局镜像

只要 composer.json 里有 repositories 字段（哪怕只是空数组 []），全局镜像配置就完全失效，Composer 只按你写的 URL 拉元数据。

Discussion Composer

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

下载

• 运行 composer config --list | grep repositories，如果输出非空，说明项目级配置已接管
• 检查 repositories 是对象还是数组：写成 {"packagist.org": false} 是对的；写成 "packagist.org": false（没包在数组里）会被忽略
• 私有源必须放 repositories 数组前面，且 {"packagist.org": false} 必须单独作为最后一项
• 如果用了 "type": "vcs" 却配了 Satis 地址，Composer 会尝试 git clone HTML 页面，直接报错

镜像 URL 少斜杠引发无限 redirect

阿里云、腾讯云等中文镜像要求 URL 必须以 / 结尾，否则服务端 301 重定向到带斜杠地址，而 Composer 不自动补斜杠，形成死循环。

• 错误写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer（结尾没 /）
• 正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 验证是否生效：composer config -g repo.packagist 输出必须是完整 JSON，含 "url": "https://mirrors.aliyun.com/composer/"
• 用 curl -I -L https://mirrors.aliyun.com/composer/packages.json 看跳转链，反复 302 Found 说明镜像或 CDN 配置异常

Git 子模块里 require 包失败，根本没走到镜像这步

子模块默认不检出内容，modules/my-submodule/ 目录下可能为空，Composer 连 composer.json 都读不到——它压根没触发“查镜像”流程。

• 执行 git submodule status：输出含 - 开头或无输出，说明未初始化
• 在项目根目录运行：git submodule update --init --recursive
• 进入子模块目录，确认存在合法 composer.json（至少含 name 和 autoload 字段）
• 子模块不继承父项目的镜像配置；若需统一源，应在子模块自己的 composer.json 中写入 repositories 字段

真正卡住的地方，往往不是镜像有没有包，而是缓存路径和配置优先级这些细节——比如删错缓存目录、repositories 写成数组却期待对象行为、或者 URL 少了个斜杠，结果整个请求链都绕回官方源还浑然不觉。