报“repository not found”或“invalid repository”时，90%是配置本身不合法：type与url不匹配、url协议错误或服务端未返回预期json；需用composer diagnose定位失败项，并以curl或git ls-remote验证真实可达性。
报“Repository not found”或“invalid repository”时，90% 是配置本身不合法
Composer 不会因为网络不通就报这个错，它是在解析 repositories 字段时直接校验失败——连 HTTP 请求都不会发。常见硬性规则被违反就会触发：
-
type: "composer"必须配以 HTTPS URL 且末尾带/，例如https://mirrors.aliyun.com/composer/；写成https://mirrors.aliyun.com/composer（缺斜杠）会导致内部拼出/composerpackages.json这种非法路径，404 后直接判“无效” -
type: "vcs"只接受 Git/SVN/Hg 协议地址，https://github.com/user/repo.git✅，https://github.com/user/repo❌（网页地址不认） -
type: "package"不需要url字段，但必须提供完整package对象，含name、version、dist或source - 运行
composer diagnose，它会明确指出哪条repositories“failed to parse”，比手动猜快得多
全局镜像配置 repo.packagist 在 Composer 2.2+ 已废弃
如果你用的是 Composer ≥ 2.2（当前主流版本），composer config -g repo.packagist 这条命令已失效——它不会报错，但也不会写入任何有效配置。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确写法是两行设置：
composer config -g repositories.packagist.org.type composer和composer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/ - 验证是否生效：运行
composer config -g repositories.packagist.org.url，输出必须是完整 URL，不能是空或https://packagist.org - 项目级配置优先级更高：只要项目
composer.json里有"repositories": []（哪怕空数组），全局配置就完全被跳过，不是“不优先”，是彻底不读
私有仓库 URL 看似正确，但实际不可达
别信 Composer 的错误提示，它只说“repository invalid”，不说“你连不上”。得用底层命令验证真实响应：
- 对
type: "composer"仓库：执行curl -I https://your-repo.com/packages.json，必须返回HTTP/2 200且响应体是合法 JSON（顶层含"packages"键） - 对
type: "vcs"仓库：执行git ls-remote -h https://your-git.com/user/repo.git，能列出 ref 才算通；若报fatal: unable to access，问题在证书、代理或 DNS - Docker 场景下，
localhost指容器自身，想连宿主机服务，URL 得写成http://host.docker.internal:8080（Linux 需加--add-host=host.docker.internal:host-gateway启动） - 公司内网走代理时，
COMPOSER_HTTP_PROXY必须显式设置；Composer 默认不读系统.gitconfig的 proxy 配置
缓存残留导致“版本找不到”，清缓存 ≠ 刷新元数据
composer clear-cache 不会删掉最关键的 provider-*.json 文件——这些文件缓存了镜像的索引结构，过期后 Composer 就“看不见”新发布的版本。
- Composer ≥ 2.5：直接运行
composer update --refresh，它精准清理 provider 相关 JSON，不碰已下载包 - 老版本：手动删缓存目录，路径按镜像 URL 转义，例如
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer - 临时验证：加
--no-cache参数，如composer show -a vendor/pkg --no-cache，强制走网络请求绕过本地索引（仅诊断用，慢） - 注意：某些镜像（如部分高校源）返回 HTML 页面（人机验证），
curl -I返回200 OK但内容不是 JSON，这种镜像不适合自动化场景
