composer update vendor/package 不拉 dev-main 是因默认仅在 lock 文件锁定范围内更新，dev-main 不属语义化版本约束；需显式执行 composer require vendor/package:dev-main，并确保镜像同步最新 commit。
composer update vendor/package 为什么没拉到 dev-main 分支？
因为 composer update 默认只在 composer.lock 已锁定的版本范围内找兼容更新，而 dev-main 是开发分支，不属于语义化版本约束（如 ^3.0）的“可选池”。它压根不会被纳入求解范围。
常见现象：执行 composer update vendor/package 后终端显示 Nothing to install or update，但你刚 push 了新 commit 到 main 分支，且确认镜像站已同步该包元数据。
- 必须显式指定分支名：用
composer require vendor/package:dev-main（注意冒号后无空格） - 分支含斜杠（如
feature/login）必须加引号：composer require vendor/package:"dev-feature/login" - 若包未上 Packagist 或使用私有 Git 仓库，需先在
composer.json的repositories字段中声明 VCS 类型源：{"type": "vcs", "url": "https://github.com/user/repo"} - 装完后
vendor/下看到的是 commit hash，不是分支名——这是正常行为；后续要拉最新提交，得再跑一次composer update vendor/package
镜像不同步导致 dev 分支拉不到最新 commit？
国内镜像（如阿里云、腾讯云）对 dev- 分支的同步存在延迟，尤其非 tagged 提交。即使你在 GitHub 上看到新 commit，镜像的 packages.json 可能仍缓存着旧的 dev-main 对应的 commit hash。
验证方式：手动访问镜像站对应包地址，例如 https://mirrors.aliyun.com/composer/p/vendor/package-name.json，搜索 "dev-main" 字段，看 "reference" 值是否为你期望的最新 commit。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先清元数据缓存：
composer update --refresh（Composer ≥ 2.5），它会强制重载packages.json，不碰 ZIP 缓存 - 老版本 Composer（rm -rf $(composer config --global cache-dir)/repo/https---mirrors.aliyun.com-composer
- 临时绕过镜像直连 GitHub（仅调试）：
COMPOSER_REPO_PACKAGIST=https://packagist.org composer require vendor/package:dev-main - 别信
composer clear-cache—— 它清 ZIP 包但不保证元数据刷新，对 dev 分支无效
想重拉 dev 分支但不想动 lock 文件或子依赖？
默认 composer update vendor/package 会连带升级其子依赖（如 psr/log），而 dev-main 通常对应不稳定代码，隐式升级容易引发 break change。
安全做法是切断依赖树联动，只重装目标包本身：
- 在
composer.json中把目标包写成精确 commit 引用："vendor/package": "dev-main#abc1234"（abc1234替换为最新 commit hash） - 执行：
composer update vendor/package --no-update-with-dependencies（Composer ≥ 2.5） - 加
--force-reinstall确保即使 commit hash 不变，也强制重新下载 dist ZIP（修复损坏或缓存污染场景） - 终端必须出现
Downloading https://行，且vendor/package目录下文件修改时间刷新，才算真正生效
为什么 vendor/package 下还是旧代码？
即使命令成功，vendor/ 里可能仍是旧文件——因为 Composer 默认优先从本地缓存解压 ZIP，而不是走网络。尤其 CI/CD 环境中，构建日志看似成功，产物却来自 3 天前的缓存。
- 查缓存路径：
composer config --global cache-dir - 清 dist 缓存：
composer clear-cache（不要手动rm -rf，会破坏结构） - 强制走网络：
composer update vendor/package --no-cache（配合--refresh使用才有效） - CI 脚本里务必加上这两步，否则每次构建都可能复用旧二进制
dev 分支的 commit hash 变更频繁，缓存失效策略比稳定版更敏感；漏掉 --no-cache 或缓存未清，就等于还在用上周的代码。
