composer 引用中文 github 项目与英文项目完全相同，只依赖 composer.json 的 name 字段、仓库 url 可克隆性及版本约束匹配；关键在于 repositories 必须置于根 composer.json 顶层且 type 为 vcs，url 需完整可 clone（https 含 .git 后缀），require 的包名须与目标仓库 composer.json 中 name 字段严格一致（含中文、全角/半角、空格），无 tag 时需显式指定 dev-main 并配置别名或 minimum-stability，私有库需配置 github token 或 ssh 认证，且务必确保目标仓库 composer.json 规范有效。
Composer 引用 GitHub 上的中文项目，和英文项目完全一样——它不识别语言，只认 composer.json 里的 name 字段、仓库 URL 的可克隆性，以及版本约束是否匹配。所谓“中文项目”只是仓库名或描述含中文，不影响 Composer 行为；真正卡住你的，往往是配置细节没对齐。
repositories 必须写在根 composer.json 顶层，且 type 是 vcs
很多人把 repositories 塞进 config 或 extra 里，结果 composer require 依然报 Could not find package。这不是网络问题，是 Composer 根本没读到你写的源。
-
repositories必须是根级键，和require、autoload并列 -
"type": "vcs"是硬性要求，写成"git"、"package"或留空都无效 -
url要填完整可git clone的地址：HTTPS 格式必须带.git后缀（如"https://github.com/中文-org/中文-repo.git"），SSH 格式必须是"git@github.com:中文-org/中文-repo.git" - URL 中的中文字符本身没问题（GitHub 支持 UTF-8 路径），但确保本地 Git 能正常 clone（终端执行
git clone https://github.com/中文-org/中文-repo.git先验证）
require 的包名必须和仓库内 composer.json 的 name 字段一字不差
Composer 不从 URL 推导包名。哪怕你写 composer require 中文-org/中文-repo，只要该仓库 composer.json 里写的是 "name": "zhongwen-org/zhongwen-repo"，就会失败。
- 打开目标仓库的
composer.json，确认name字段值（比如"name": "my-company/工具包"） -
require里必须照抄，包括中文、全角/半角符号、斜杠方向——"my-company/工具包"和"my-company/工具包 "（末尾多空格）都不行 - 如果仓库
composer.json没写name，或语法错误（如逗号漏写），Composer 直接跳过，不报错但找不到包
dev-main 或无 tag 仓库需显式允许非稳定版本
中文项目常处于开发阶段，没打 v1.0.0 这类 tag，只推了 main 分支。此时 composer require 中文-org/中文-repo:dev-main 仍可能失败，提示 no matching package found。
- 默认
minimum-stability是stable，dev-main属于dev级别，被策略拦截 - 两种解法：
– 全局放宽（不推荐）：在根composer.json加"minimum-stability": "dev"
– 精准控制（推荐）：用别名写法"中文-org/中文-repo": "dev-main as 1.0.0"，这样只对该包生效，其他依赖仍走 stable - 注意：
dev-main锁定的是执行composer install时main分支的 HEAD 提交，不是实时更新
私有中文仓库要配认证，且不能依赖浏览器登录态
GitHub 私有库用 HTTPS 地址时，Composer 不走浏览器 Cookie，必须显式提供凭据。
- 推荐方式：生成 GitHub Personal Access Token（勾选
repo权限），然后运行：composer config github-oauth.github.com YOUR_TOKEN - 不推荐方式：用
git config --global credential.helper store存密码，但 token 过期后容易静默失败 - SSH 方式更可靠，但要求
ssh -T git@github.com能通，且~/.ssh/config中 Host 名与 URL 域名一致（如Host github.com） - 认证失败时现象通常是卡在
Cloning into '...'或报Could not fetch，日志里看不到明确错误
最易被忽略的点：中文项目往往缺少规范的 composer.json，比如没写 autoload，导致类文件存在却无法自动加载；或者 name 字段用了非法字符（如空格、全角标点），Composer 解析失败但不报具体位置。动手前，先 fork 一份，检查并修复目标仓库的 composer.json 再引用，比反复调配置更省时间。
