生效，但只对已同步到镜像的版本生效；私有Git包完全不走镜像，require时若版本未同步或配置错误（如缺末尾/、项目级repositories覆盖全局），会导致“Could not find package”等错误。
composer require 指定版本时，镜像源是否生效？
生效，但只对已同步到镜像的版本生效。镜像不是代理转发，而是独立同步的副本——composer require monolog/monolog:2.9.1 能成功，前提是阿里云/腾讯云镜像里已有 2.9.1 这个 tag 的元数据和 dist 包；如果该版本刚发布不到 5 分钟，镜像还没同步，就会 fallback 到 packagist.org 或直接报错。
为什么写了 1.2.3 却装了 dev-main？
常见于两种情况：一是该版本根本没被镜像同步（比如作者刚 push tag，镜像尚未抓取）；二是你写的版本字符串被 Composer 解析为分支名而非 tag。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
v1.2.3会被当成分支名dev-v1.2.3，镜像里当然找不到 -
1.2.3才是正确写法，Composer 会查packages.json中是否有匹配的version字段 - 运行
composer show monolog/monolog --all，确认输出里真有1.2.3这一行（带tag标记），再require - 若
composer.lock中该包的source.type是source且source.reference是 40 位哈希，说明实际拉的是 dev 分支，不是你想要的 tag
私有 Git 包 + 特定 tag 走不走镜像？
完全不走。镜像只覆盖 type: "composer" 仓库（即 packagist.org 的公开索引），私有 Git 地址如 "git@github.com:user/repo.git" 或 HTTPS VCS URL，Composer 直连 Git 服务器，镜像配置对其无影响。
- 要装私有仓库的 tag，必须先在
composer.json的repositories中声明"type": "vcs" - 然后用
composer require vendor/package:dev-main#v1.2.3或dev-main#abc123（commit hash） - 加
--prefer-source可避免因 zip dist 缺失导致失败，尤其适合 CI 环境 - 别指望
--repository-url=https://mirrors.aliyun.com/composer/能让私有包走镜像——它只改元数据获取地址，不改 Git 克隆行为
镜像配置错误导致 require 失败的典型现象
不是“速度慢”，而是 Could not find package xxx at version yyy 或 Could not resolve packages，本质是镜像配置未真正启用或与项目级设置冲突。
-
composer config -g repo.packagist返回空？说明全局配置写错了——漏了-g、键名写成repos.packagist（多 s）、URL 少了末尾/ - 项目根目录有
composer.json且含"repositories"数组？它会覆盖全局配置，此时需检查数组第一项是不是{"packagist.org": false} - 用了
--repository-url参数但依赖链里某个子包不在该镜像中？Composer 不递归切换源，会卡住或 fallback，这不是 bug，是设计限制 - 清缓存必须用
composer clear-cache，composer update --no-cache不够——旧 metadata 可能还在本地磁盘
require 的影响，核心就一条：它只加速「已同步」的公开包版本。一旦涉及未同步 tag、私有源、或配置未真正生效，问题根源从来不在网络，而在 Composer 对源和版本的解析逻辑本身。 
