composer报“could not find package”90%是私有包未声明仓库、auth.json缺失或权限错误，或配置repositories后未显式启用packagist.org导致连monolog/monolog都无法安装。
直接说结论：Composer 报 Could not find package，90% 不是网络或镜像问题，而是私有包没声明仓库、auth.json 缺失或权限不对、或者你一配置 repositories 就把官方源给关了——连 monolog/monolog 都装不上。
composer.json 里加了 repositories 却连公共包都找不到
这是最隐蔽也最常踩的坑：只要你在 composer.json 的 repositories 字段里写了任意一条记录（哪怕只加了一个 Git 地址），Composer 就会默认关闭 packagist.org 自动注入。
结果就是：你的私有包没配对，公共包也全失效。
-
"packagist": false必须作为repositories数组的第一项，否则无效 - 第二项起必须显式写上官方源：
{"type": "composer", "url": "https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19"}，不能用package或artifact类型替代 - 私有 Git 仓库要单独加一条
{"type": "vcs", "url": "https://gitlab.internal.company.com/group/pkg"} - 改完立刻执行
composer clear-cache，否则旧缓存还在用“无 packagist”的配置
auth.json 权限不对或格式错，认证就白配
Composer 只读取项目根目录（与 composer.json 同级）的 auth.json，且严格校验文件权限和 JSON 结构。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS 下必须运行
chmod 600 auth.json，否则 Composer 直接忽略该文件 - Windows 用户要确认文件名是纯
auth.json，不是auth.json.txt；还要检查是否被编辑器自动加了 BOM 头 - HTTP Basic 认证格式必须是：
{"http-basic": {"gitlab.internal.company.com": {"username": "deploy", "password": "xxx"}}}，域名必须完全匹配 URL 中的 host 部分 - GitHub 私有库用
github-oauth，Token 需带repo权限，不能只填read:packages
包名大小写、vendor 名拼错，Composer 不会提醒你
Composer 匹配包名是精确字符串比对，不纠正、不提示、不模糊搜索。输错一个字符，报错就是 Could not find package，而不是 “您是不是想搜 xxx？”
- 访问 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19 搜索完整
vendor/name，复制粘贴进命令，别手敲 -
spatie/laravel-backup≠spatie/backup≠Spatie/Laravel-Backup - 私有包的
name字段必须和composer require时写的完全一致——包括大小写、连字符、点号，且必须与它自己composer.json里的"name"值一字不差 - 终端里用中文输入法打斜杠
/，可能混入全角字符，导致解析失败但错误信息不体现
Git 仓库地址可访问，但 Composer 还是 404
这通常不是权限问题，而是元数据获取失败：Composer 需要能从 Git 仓库中解析出 composer.json 内容，并识别有效版本（tag 或 branch 别名）。
- 手动执行
git ls-remote --heads https://gitlab.internal.company.com/group/pkg main，确认分支存在且可拉取 - 确保仓库根目录有合法
composer.json，且含"name": "myorg/my-private-package"字段 - 如果只靠
dev-main安装，需加--stability=dev --prefer-source，否则默认跳过 - 用 SSH 地址（如
git@gitlab.internal.company.com:group/pkg.git）时，先确认ssh -T git@gitlab.internal.company.com能通，且~/.ssh/config主机别名映射正确
真正麻烦的从来不是配 auth.json，而是配完之后忘了 "packagist": false 必须放第一行，或者以为加了仓库就能自动 fallback 到官方源——Composer 不 fallback，它只查你列出来的那几个地方，一个都不能少。
