Composer install报错提示分支代码未同步？强制拉取最新依赖-composer-PHP中文网

答案是composer install不查远程，只按lock文件的commit hash安装；必须先执行composer update --refresh刷新元数据，再运行composer require vendor/package:dev-main才能拉取最新提交。

composer install报错提示分支代码未同步？强制拉取最新依赖

composer install 为什么没拉到 dev-main 最新提交

因为 composer install 完全不查远程，它只按 composer.lock 里记录的 commit hash 去缓存或镜像找 ZIP 包——哪怕你刚 push 了新代码，只要 lock 文件没更新，它就当不存在。

常见现象：GitHub 上能看到 dev-main 的最新 commit，但 composer install 后 vendor/ 里还是旧 hash；composer update vendor/package 也显示 Nothing to install or update。

根本原因不是镜像没同步，而是本地 packages.json 缓存过期（默认 15 分钟），Composer 根本没去镜像站查新分支信息
composer clear-cache 只清 ZIP 包，不刷新元数据，对 dev-main 无效
必须先让 Composer 拉到最新元数据，再触发依赖重解析，否则 lock 文件永远“看不见”新 commit

强制同步 dev-main 分支元数据并更新 lock

分两步走：先刷新远程索引，再显式要求装指定分支。跳过任何一步都会卡在旧状态。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

刷新元数据（Composer ≥ 2.5）：composer update --refresh —— 它只删 packages.json 和 provider 文件，不碰 ZIP 缓存，快且精准
老版本 Composer（rm -rf $(composer config --global cache-dir)/repo/https---mirrors.aliyun.com-composer
然后执行：composer require vendor/package:dev-main（注意冒号后无空格）
分支名含斜杠（如 feature/login）必须加引号：composer require vendor/package:"dev-feature/login"

私有仓库或未上 Packagist 的包怎么拉 dev 分支

如果包不在 Packagist，或用的是 GitHub 私有库，composer require 默认找不到，必须提前声明源类型。

在 composer.json 的 repositories 字段加 VCS 源：

{"type": "vcs", "url": "https://github.com/yourname/repo"}

确保该仓库的 dev-main 分支存在且可公开访问（私有库需配 SSH key 或 token）
执行 composer require 前，先跑一次 composer update --refresh，否则新 repository 配置不会被读取
装完后 vendor/ 下看到的是 commit hash，不是分支名——这是正常行为；后续要拉最新提交，得再跑 composer update vendor/package

镜像同步延迟导致 dev 分支拉不到最新 commit 怎么办

国内镜像（阿里云、腾讯云）对 dev- 分支的同步普遍有 5–15 分钟 lag，尤其非 tagged 提交。不能只等，得验证+绕过。

手动验证镜像是否已同步：curl -s https://mirrors.aliyun.com/composer/p/vendor/package-name.json | grep -A2 dev-main，看 reference 字段是否为你期望的 commit
若未同步，临时直连 Packagist 调试：COMPOSER_REPO_PACKAGIST=https://packagist.org composer require vendor/package:dev-main
别信 --no-cache —— 它只禁用 ZIP 缓存，不影响元数据复用；真正要的是 --refresh 或手动删 repo 缓存
CI 流水线中建议加 composer install --dry-run 并检查输出是否含镜像域名，避免 fallback 到官方源导致结果不一致

最易被忽略的点：dev 分支没有语义化版本约束，composer update 默认不碰它；你必须用 require 显式声明，且每次拉新 commit 都得重新触发这个流程——它不像 tagged 版本那样能靠 ^ 自动滚动。