composer https拉私有git仓库卡在“could not read username”是因git凭据管理器未配置，需用git config --global credential.helper store并执行含token的git clone命令保存凭据，而非手动输密码。
HTTPS方式拉私有Git仓库总卡在“could not read Username”
这是 Composer 用 git clone 走 HTTPS 协议时，系统 git 凭据管理器没准备好导致的。它不会弹出交互式输入框，也不会读取你终端里输的密码——直接失败。
最稳解法不是输密码，而是把 token 拼进 URL 或交给 git 凭据缓存：
-
git config --global credential.helper store，然后手动跑一次git clone https://user:token@gitlab.example.com/org/pkg.git（注意是完整 Git URL，结尾带.git），git 会把凭据存到~/.git-credentials - GitHub/GitLab 的 Personal Access Token（PAT）必须含
repo（GitHub）或read_repository（GitLab）权限；token 别硬塞进composer.json，也别提交到 Git - 如果用
https://<token>@github.com/...</token>这种写法，要确保 token 权限够、URL 格式对（结尾.git）、且没被防火墙拦截（比如企业网络封了 443 以外的 HTTPS 端口）
auth.json 放哪儿才生效？为什么 GitLab 总报 “Could not fetch … curl error 22”
auth.json 必须放在 ~/.composer/auth.json，不能放项目根目录，也不能靠 COMPOSER_AUTH 环境变量临时覆盖——GitLab 的 token 不走 bearer header，只认这个路径下的文件。
内容格式必须严格：
{
"gitlab-token": {
"gitlab.example.com": "glpat-xxxxxxxxxxxxxxxxxxxx"
}
}
常见错因：
- 权限不对：
chmod 600 ~/.composer/auth.json没执行，Composer 会忽略该文件 - 域名写错：比如写了
https://gitlab.example.com（带协议）或大小写不一致（GitLab.example.com≠gitlab.example.com） - GitLab 实例 API 关闭或未启用
read_api权限，导致 Composer 访问/api/v4/projects/xxx失败
repositories 配置 type: "vcs" 但包还是找不到
不是所有 URL 都能当 vcs 仓库用。Composer 只认可被 git clone 直接拉下来的地址，且要求目标仓库根目录下有合法的 composer.json。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
务必检查：
- URL 是 Git 克隆地址，不是网页地址：
https://gitlab.example.com/myorg/my-pkg.git✅，https://gitlab.example.com/myorg/my-pkg❌（缺.git） -
type必须是"vcs"，不是"package"或"composer"；后者需要手动维护元数据，不支持自动解析分支/标签 - 包名（如
myorg/my-pkg）必须和 Git 仓库的 namespace + repo name 完全一致，大小写敏感，子组路径（如myorg/team-a/pkg）也要一字不差 -
composer require myorg/my-pkg不会自动加repositories声明，得自己补进composer.json的repositories数组里
--prefer-source 死活不走 git clone，日志里全是 “Downloading xxx.zip”
这说明 Composer 回退到了 dist 模式，不是配置没生效，而是 source 路径被绕过了。
典型原因：
- 包的
composer.json里写了"dist":{...}但没提供"source"字段，Composer 就没源码可拉 - 网络策略屏蔽了
git协议端口（如 SSH 的 22 或 Git 的 9418），Composer 静默 fallback，不报错也不提示 - 用了某些插件（如
platform-check）或自定义 installer，它们可能跳过 source 逻辑 - 缓存里已有 dist 包：加
--no-cache或清掉~/.composer/cache再试
验证是否真走了 source：看安装输出里有没有 Cloning [hash] from [url]；只有 Downloading [url].zip 就说明没成功。
真正难搞的不是怎么配，而是哪一层在静默 fallback —— 日志不报错，凭据又看似有效，最后发现是 GitLab 的 API 返回 403 却被 Composer 吞掉了。这种时候得开 -vvv，盯着每一条 HTTP 请求和 git 命令输出看。
