必须在composer.json的repositories中声明vcs类型仓库，url为完整git地址，且目标仓库composer.json的name字段须与require中的包名完全一致；否则报“could not find package”。
怎么让 composer require 装 GitHub 私有库或未提交到 Packagist 的包
必须在项目根目录的 composer.json 里加 repositories 字段，类型选 vcs，URL 写完整 Git 地址（如 https://github.com/your-org/your-private-package）。不是所有 Git 仓库都能直接装——关键看目标仓库根目录下有没有合法的 composer.json，且其中 name 字段必须存在、格式为 vendor/name，且和你 require 里写的完全一致（大小写、分隔符都不能错）。
常见错误现象：
-
Could not find package xxx：多半是name拼错，或目标仓库没写name - 执行
composer show不显示该包：先检查repositories是否在顶层，再加-vvv看日志是否探测到源 - 用
composer config repositories.xxx vcs https://...临时配置：不推荐，会把配置错写进"config"字段，语义混乱
装 dev-main 或特定分支时为什么总失败
Composer 默认只信任稳定版本（stable），而 dev-main、dev-feature/x 属于开发版，需显式放宽约束。单纯加 --ignore-platform-reqs 没用，真正要动的是稳定性策略。
推荐做法：
- 在
composer.json顶层加"minimum-stability": "dev"和"prefer-stable": true（后者保稳定包优先） - 若只想对单个包放开，可在
repositories里硬指定分支映射："versions": { "dev-main": "dev-main" }，但安装时仍需写明dev-main版本约束，例如composer require vendor/name:dev-main - 避免用
dev-master—— Composer 2.2+ 已弃用该别名，应统一用dev-main
Git 包更新后 composer update 不拉新 commit 怎么办
Composer 不会自动追踪 Git 最新 commit，它只认 composer.lock 里记录的 source.reference（即某个固定 commit hash）。即使远程分支已更新，只要 lock 文件没变，vendor 目录就不会动。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操步骤：
- 先确认远程确实有新 commit：
git ls-remote https://github.com/xxx/yyy.git main | head -1 - 清缓存：
composer clear-cache - 强制重拉：
composer update vendor/name --with-dependencies - 如果仍无效，删掉
vendor/vendor/name和composer.lock中对应段，再运行composer install
注意：不要依赖 composer update 自动升分支 —— 它不会帮你切到新 commit，除非你改了版本约束或删锁文件。
镜像配置写错就等于没配，怎么验证真正在用
执行 composer config -g repo.packagist 只显示配置值，不反映真实请求行为。很多人的镜像看似生效，实际请求仍在走 packagist.org。
可靠验证方式：
- 运行
composer clear-cache && composer require monolog/monolog -vvv 2>&1 | grep "GET\|Downloading"，观察 URL 是否含mirrors.aliyun.com等镜像域名 - 用
composer show -v | head -n 5，看日志里出现的下载地址 - 若输出含
packagist.org或已失效域名（如phpcomposer.com），说明配置失败或被覆盖
容易被忽略的点：项目级 composer.json 中若定义了 repositories 数组（哪怕只有一行 {"packagist.org": false}），全局镜像配置就会被彻底忽略 —— 这是优先级规则，不是 bug。
