composer拉不到私有包主因是url格式错误：https地址缺.git后缀、ssh地址误用斜杠分隔、或未配ssh密钥；同时需确保repositories声明在项目根composer.json中，type为vcs，且require的包名与私有库composer.json的name字段严格一致。
Composer拉不到GitLab/Gitee私有包，是不是URL写错了？
不是网络或权限问题，大概率是URL格式不合法。Composer要求VCS仓库URL必须是能被git clone直接执行的地址，不是网页链接。
常见错误：
- 写成
https://gitlab.example.com/group/project（缺.git后缀）→ 报No valid composer.json was found - 写成
https://gitee.com/owner/repo/tree/main（带/tree/main路径）→git clone失败 - SSH地址没配好
~/.ssh/id_rsa或ssh-agent未启动 → 卡在Cloning into '...'...
正确写法：
- HTTPS：
https://gitlab.example.com/group/project.git（结尾必须带.git） - SSH：
git@gitlab.example.com:group/project.git（冒号分隔，非斜杠）
为什么加了repositories还是提示“Could not find package”？
根本原因是repositories和require没对齐，或者包名大小写/分隔符不一致。
Composer不会自动推导包名，它只按require里写的vendor/name去每个repositories中匹配——且严格区分大小写、连字符和下划线。
检查点：
- 目标仓库根目录下的
composer.json中"name"字段是否完全一致？比如"corp/logger"≠"Corp/Logger"≠"corp_logger" -
repositories数组是否放在项目级composer.json里？全局配置config或auth.json不生效 - 是否把
packagist.org源放到了repositories数组末尾？它会优先命中公开包，跳过你定义的私有源
建议把私有源放在数组最前面，显式禁用Packagist：
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/corp/logger.git"
},
{
"type": "composer",
"url": "https://packagist.org",
"packagist": false
}
]
装了VCS包但类找不到，autoload没生效？
VCS包的自动加载行为和Packagist包完全一样，但容易漏掉两个硬性前提。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须同时满足：
- 目标仓库的
composer.json中已正确定义autoload段（如"psr-4": {"Corp\Logger\": "src/"}） - 你本地执行的是
composer update vendor/name，不是install——因为install只读composer.lock，不会重新解析VCS元数据
验证方式：
- 进
vendor/vendor/name目录，确认composer.json存在且autoload字段非空 - 运行
composer dump-autoload后，检查vendor/autoload.php是否包含该包命名空间映射
注意：dump-autoload本身不触发安装，它只刷新已存在的映射。
新打了tag却update不到，缓存怎么清？
Composer会缓存VCS仓库的远程元数据（包括tag列表），不是实时拉取。新tag推送后，composer show vendor/name仍看不到，就是缓存没刷新。
有效清理方式：
- 局部清缓存：
composer clear-cache（影响所有包，但最稳妥） - 单包绕过缓存：
composer update vendor/name --no-cache - 临时禁用缓存：
COMPOSER_CACHE_DIR=/dev/null composer update vendor/name
别忘了同步Git层：
- 确认
git push --tags已执行（不是git push） - tag名必须符合版本规范，如
v1.2.3或1.2.3，不能是release-1.2.3
最容易被忽略的是：VCS包的版本解析完全依赖Git tag，没有tag就 fallback 到dev-main，此时require写"^1.2"会失效。
