Composer项目配置私有仓库拉取特定分支代码-composer-PHP中文网

composer配置vcs仓库必须设"type":"vcs"且"url"以.git结尾，包名须与仓库composer.json中"name"完全一致；dev-分支名需真实存在，认证需通过auth.json或global config配置对应token。

composer项目配置私有仓库拉取特定分支代码

composer.json里配置vcs仓库必须写对type和url格式

私有 Git 仓库不能直接用 HTTPS 或 SSH 地址当包名，必须显式声明为 vcs 类型源。否则 Composer 会跳过它，继续去 Packagist 找包，最终报 Could not find package vendor/name。

正确写法是：

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/your-org/your-private-package.git"
    }
  ],
  "require": {
    "your-org/your-private-package": "dev-main"
  }
}

注意三点：

url 必须以 .git 结尾，否则 Composer 无法识别为 Git 仓库
包名 your-org/your-private-package 必须和仓库根目录下 composer.json 里的 "name" 字段完全一致（包括大小写）
如果用 SSH，url 写成 git@github.com:your-org/your-private-package.git，需提前配好 SSH key，且 ssh -T git@github.com 能通

拉 dev 分支要加 dev- 前缀，但分支名必须真实存在

dev-main、dev-10.x、dev-feature/login 都合法，前提是远程仓库真有这个分支。GitHub 默认分支叫 main，不是 master，写 dev-master 就会 404。

常见错误现象：

报错 Could not find branch dev-main：实际分支叫 main，但远程没设 dev-main 别名，此时应直接写 main（不加 dev-）
报错 No driver found for xxx.git：url 写成了 https://github.com/xxx/yyy#main 这种带 fragment 的地址——create-project 不支持 URL 作为包名，只认 vendor/name 格式
分支名大小写敏感：Dev-Main ≠ dev-main，GitHub 上它们是两个分支

认证失败时优先检查 auth.json 和 token 权限

私有仓库返回 403 或 Could not fetch https://api.bitbucket.org/，大概率是认证没走通，不是配置写错了。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

Bitbucket/GitHub/GitLab 各有要求：

GitHub：用 Personal Access Token，scope 至少含 repo；配置命令是 composer config --global github-oauth.github.com <token></token>
GitLab：同样用 PAT，配置为 composer config --global gitlab-oauth.gitlab.com <token></token>
Bitbucket：必须用 App Password（不是 API token），且权限勾选 Repositories: Read；配置方式是往 auth.json 里手动写 {"bitbucket.org": {"consumer_key": "...", "consumer_secret": "..."}}，官方不支持 composer config --global 直接设

验证是否生效：运行 composer diagnose，看输出里有没有 Authentication configured 提示。

拉到分支但装的不是最新提交？检查 composer.lock 和 require 版本约束

即使指定了 dev-main，composer install 仍可能装旧版，因为 composer.lock 锁定了上次解析出的 commit hash，或者 require 里写了 "laravel/framework": "^10.0" 这类约束，压制了分支更新。

解决方法分场景：

想强制重拉最新 main：删掉 composer.lock + vendor/，再跑 composer install --prefer-source（--prefer-source 确保克隆 Git，不是下 zip）
只想更新某一个私有包：用 composer update your-org/your-private-package --with-dependencies
require 中版本写死导致冲突：把 "your-org/your-private-package": "dev-main" 改成 "your-org/your-private-package": "dev-main as 1.0.99"，用 as 别名绕过语义化版本校验