composer why查不到包的主因是：包未安装、属require-dev未加-d参数、或为root package自身声明；它只显示直接依赖，不展开间接链，需用composer show手动逐层追查。
composer why 查不到包？先确认这三件事
查不到不是命令没用，而是条件不满足。常见情况就三种：
- 包根本没装上——比如拼错名字：
composer why guzzlehttp/guzzel（少个l）肯定返回空 - 包在
require-dev里，但没加-D参数：composer why -D phpunit/phpunit才能查到 - 这个包是你自己写在
composer.json的require里的——composer why不查“自己为啥要它”，只查“谁把它拉进来的”
另外，composer why 默认只显示一级上游依赖，不会自动展开整条链。想看到完整路径，得手动追：先查出上层包，再用 composer show 上层包名 看它的 requires 列表，一层层往下摸。
composer why-not 报“Package not found”？版本号必须精确
composer why-not 是唯一能精准定位阻断点的只读命令，但它对输入极其敏感：
- 必须带完整版本号，比如
laravel/framework:10.0.0，写^10.0或10.*都会报错 - Composer 版本必须 ≥ 2.2，否则提示
Command "why-not" is not defined，先跑composer self-update --2 - 如果目标包是通过
require-dev间接引入的，得加--with-all-dependencies，否则可能漏掉关键约束
输出里以 requires 开头的行，说明某个已安装包硬性绑定了冲突版本；以 conflicts 开头的，就是真死锁，没法绕过去。
镜像配置总失效？三个细节决定成败
换源后还是卡在 Downloading，八成是镜像没生效。问题通常出在这三点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命令写错键名：
repo.packagist不能写成repos.packagist（多一个s就静默忽略） - 漏掉
composer这个 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/中中间那个composer不可省 - URL 缺末尾斜杠：
https://mirrors.aliyun.com/composer/必须带/，不带就会 fallback 到官方源，且不报错
验证是否成功，只看这一句：composer config -g repo.packagist。输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报 Key 不存在，说明没写进去。
项目级镜像为什么比全局更靠谱？权限和 Git 可见性
宝塔、CI、团队协作时，全局配置基本靠不住——因为 composer config -g 写的是 /root/.composer/config.json，而宝塔用 www 用户运行，GitHub Actions 用 runner 用户，它们根本读不到。
项目级配置直接改 composer.json，Git 能追踪、新人 clone 即生效：
- 进项目根目录，执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意去掉-g） - 这条命令会自动写入
repositories字段，但要注意：它会全量替换现有repositories对象，不是追加 - 如果已有私有源，建议手动编辑
composer.json，把阿里云镜像作为"packagist"子项加入repositories，并确保顶层有"packagist.org": false
换镜像后首次 composer install 若报 hash 校验失败，删掉 vendor 和 composer.lock 重来即可。镜像只加速下载，不解决 Resolving dependencies 卡顿——那得看 composer.json 里约束写得是否合理。
