先确认包是否真实存在：访问https://packagist.org/packages/vendor/name验证页面可打开，运行composer search vendor/name检查收录情况，注意大小写与不可见字符；若存在则排查镜像同步延迟、缓存过期、repositories配置错误或私有源未生效。
“Package not found”不是网络问题，先确认包是否真实存在
报错 Could not find package vendor/name 或直接 404，第一反应不该是换镜像或清缓存，而是验证这个包在 Packagist 上是否存在。打开浏览器访问 https://packagist.org/packages/vendor/name，如果返回 404 页面，说明它压根没发布——拼错 vendor 名（比如 spatie/backup 而非 spatie/laravel-backup）、大小写错误（Monolog/monolog ❌）、或复制时带了零宽字符，都可能导致查无此包。
运行 composer search vendor/name 也能辅助判断：它只查 Packagist 全局索引，不走你本地配置的源，结果为空基本坐实包未发布。别信网页搜索或 GitHub 仓库名，Packagist 的 name 字段必须完全一致，且作者已手动提交或配好 webhook。
用了国内镜像却还是 404？检查同步状态和配置生效路径
阿里云、腾讯云等镜像不是实时全量同步，新包或 dev 分支常有 5–30 分钟延迟。别只看 composer clear-cache，它不会强制重载远程元数据——Composer 默认复用本地缓存中 15 分钟内未过期的 packages.json。
验证镜像是否真同步了目标包：
— 浏览器打开 https://mirrors.aliyun.com/composer/p/vendor/name.json（把 vendor/name 替换掉），看是否返回有效 JSON；
— 运行 composer config -g repos.packagist，确认输出是完整 JSON 对象，如 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；
— 注意键名是 repos.packagist（复数），旧模板里的 repo.packagist 在 Composer ≥ 2.2 中会被静默忽略；
— 若项目根目录 composer.json 里有 "repositories" 字段（哪怕空数组），它会**完全屏蔽**全局镜像配置，此时要查 composer config repo.packagist（不加 -g）。
私有包或 Git 仓库报 404？repositories 配置错一个字段就白搭
私有包不会出现在 Packagist，Composer 默认根本不去你配的地址找。配置漏字段、写错 type 或 URL 不合法，都会导致整个 repositories 区块被静默忽略，然后继续查默认源，结果当然是 404。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
关键点：
— type 必须是 "vcs"，写成 "git" 或 "github" 无效；
— GitLab/GitHub URL 必须是可 git clone 的地址，结尾只能是 .git，不能带 #main 或路径；
— 目标仓库根目录的 composer.json 中 name 字段必须与 composer require 的参数**逐字一致**；
— GitHub 私库需 auth.json 配 token，URL 里不能含 @username，否则认证跳过；
— 分支或 tag 名必须真实存在，dev-main 要求远程有 main 分支，1.2.3 要求有对应 Git tag，不是 v1.2.3 或 release-1.2.3。
require 加了 -w 却报 not found？其实是依赖冲突伪装的
composer require vendor/name -w（--with-dependencies）会让 Composer 强制解析当前所有已安装包的依赖树，再尝试合并新包的约束。一旦某个已有包锁定了过老的子依赖版本，而新包要求更高版本，Composer 就可能放弃整个安装，报 “not found”——它实际是 “无法满足依赖”，但错误信息没说清楚。
解决办法：
— 先去掉 -w 重试：composer require vendor/name；
— 如果必须装，运行 composer update --dry-run 看具体哪个包卡住；
— 别长期依赖 -w，它只在明确要升级整条链时有用，日常新增包不需要；
— 某些旧版 Composer 对 -w 处理更激进，建议升级到 2.x。
最易被忽略的是：私有源配置里 {"packagist.org": false} 必须是 repositories 数组中的一个独立对象，且放在私有源之后、数组末尾；写成嵌套、放错位置、或拼错键名（如 "packagist": false），都会导致 Composer 继续兜底查官方源，你的私有配置等于没写。
