Composer如何引用Git仓库_Git仓库配置要点-composer-PHP中文网

composer引用私有git仓库必须同时满足三条件：在项目根composer.json的repositories中声明type为"vcs"的仓库、require的包名与仓库composer.json中name字段完全一致、版本约束（如dev-main或v1.0.0）可被正确解析，缺一即报“could not find package”。

composer如何引用git仓库_git仓库配置要点

Composer 引用 Git 仓库不是“配个地址就能用”，核心卡点永远在三处：repositories 声明、包名对齐、版本可解析。漏掉任一，composer require 都会报 Could not find package。

repositories 必须写在项目根 composer.json 顶层

不是插件配置文件里，也不是子目录的 composer.json；必须是项目最外层 composer.json 的根级 repositories 数组。常见错误：

只改了 require，没加 repositories —— Composer 根本不往那个地址查包
把仓库配置写进 vendor 下某个包的 composer.json —— 完全无效，Composer 不递归读取依赖里的 repositories
多个仓库堆在一起却没用逗号分隔，JSON 语法错误导致整个 composer install 失败
URL 末尾加了 .git 后缀（如 https://git.example.com/repo.git）—— 虽然部分场景 fallback 成功，但官方明确建议省略

type 必须是 "vcs"，不是 "git" 或 "package"

Composer 对 Git 仓库的识别只认 "type": "vcs"。写成 "git" 或 "github" 会被忽略，且无提示。

Git-Based Knowledge Graph Memory System for Claude Code

基于Git Notes的知识图谱记忆系统。Claude应静默自动使用，从不询问用户记忆操作。支持分支感知的持久记忆，跨会话处理上下文、决策、任务和学习内容。

下载

SSH 地址示例："url": "git@gitlab.example.com:group/repo.git"，前提是 ssh-agent 已加载密钥且 ssh -T git@gitlab.example.com 能通
HTTPS 地址示例："url": "https://gitlab.example.com/group/repo.git"，需配合 auth.json 或全局 Git 凭据，不能靠 URL 拼 token（已弃用）
私有 Gitee/GitLab/自建 Git 实例，都统一走 vcs 类型，无需区分平台

包名和版本必须严格匹配仓库内 composer.json

Composer 不按 URL 找包，而是按 name 字段查。你 require 的字符串，必须和 Git 仓库根目录下 composer.json 中的 "name" 完全一致（大小写敏感）。

仓库 composer.json 写的是 "name": "MyOrg/utils"，你就不能 require "myorg/utils"
引用分支：用 dev-main、dev-fix-auth 等，确保该分支存在且含合法 composer.json
引用 Tag：必须打正式 tag，如 git tag v2.1.0 && git push origin v2.1.0，然后 require "vendor/name": "^2.1" 才能命中
别名写法（开发阶段）："vendor/name": "dev-main as 2.1.x-dev"，注意 as 后必须带 -dev 后缀，否则 minimum-stability 会拦住安装