使用Composer install命令导入私有仓库依赖的步骤-composer-PHP中文网

能导入私有仓库的前提是composer能识别并访问它，需同时满足：项目级composer.json顶层repositories配置正确（type="vcs"、url含.git或ssh格式）、auth.json路径权限及字段严格匹配域名和token、require包名与私有库composer.json中name逐字符一致。

使用composer install命令导入私有仓库依赖的步骤

能导入的前提不是“运行 composer install”，而是 Composer 已经能识别并访问你的私有仓库——否则命令会静默跳过或报 Could not find package，而不是提示“权限不足”。

确保 `repositories` 正确写在项目级 `composer.json` 顶层

Composer 只读取你当前项目根目录下的 composer.json 中的 repositories 字段，且必须是顶层数组，不能嵌套在 config、scripts 或其他任意位置。

type 必须为 "vcs"（不是 "git"、"package"，也不能省略）
url 必须是可直接 git clone 的地址：HTTPS 地址要以 .git 结尾（如 https://gitlab.example.com/team/utils.git），SSH 地址格式为 git@gitlab.example.com:team/utils.git
如果 GitLab 部署在子路径（如 /gitlab），URL 里也得带上，否则 API 请求失败
别把网页地址（如 https://gitlab.example.com/team/utils）当仓库地址用——它不带 .git 后缀，Composer 无法解析

认证方式选 HTTPS + Token 还是 SSH？看环境再决定

CI/CD 环境通常禁用 SSH agent，推荐统一用 HTTPS + Token；本地开发若已配好 SSH 密钥且能 ssh -T git@github.com 成功，SSH 更省心。

Discussion Composer

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

下载

HTTPS 方式：在 ~/.composer/auth.json 中写入精确匹配的域名配置，字段必须是 http-basic，username 为 oauth2（GitHub）或 gitlab-token（GitLab），password 是完整 token（如 glpat-xxx）
SSH 方式：确认 ssh-add -l 能列出密钥，且公钥已添加到 Git 平台的 Deploy Keys 或用户 SSH Keys 中
验证是否生效：运行 composer install -vvv，日志中应出现 Authorization: Bearer glpat-（HTTPS）或 Cloning into ...（SSH）

`require` 的包名必须和私有库 `composer.json` 中的 `name` 逐字符一致

大小写、分隔符（/ vs -）、空格，全部要对齐。Composer 不做模糊匹配，错一个字符就等于没这个包。

私有库自己的 composer.json 里写的是 "name": "myorg/utils"，你就得写 "myorg/utils": "dev-main"
如果写成 "MyOrg/Utils" 或 "myorg-utils"，composer install 会直接跳过，不报错也不拉代码
分支名也要严格对应："dev-main" 只匹配叫 main 的分支，不是所有默认分支都叫 main；不确定时先跑 composer show myorg/utils --all 看实际有哪些版本可用

装进 `vendor/` ≠ 类能自动加载

私有包的 autoload 段必须存在且路径正确，否则 new MyOrgUtilsClient() 仍会报 Class not found。

私有包的 composer.json 中 autoload 的 psr-4 路径是相对于它自己根目录的，比如 "MyOrg\Utils\": "src/"，不是 "src/MyOrg/Utils/"
改过 autoload 规则后，必须在主项目里执行 composer dump-autoload，否则 vendor/composer/autoload_psr4.php 不更新
如果私有包只用 files 加载，记得在主项目中手动 require 对应文件，或者把它改成 psr-4 并重新 dump

最关键的复杂点往往不在命令本身，而在于三处严丝合缝的匹配：项目 composer.json 里的 repositories 声明、auth.json 中的认证字段与域名精度、私有包自身 composer.json 的 name 和 autoload 定义——漏掉任一环，composer install 都不会明确告诉你哪里错了。