需在composer.json中声明VCS仓库并运行composer update --lock；分支名须严格匹配远程refs/heads下的原始名称；dev分支需加@dev后缀或配置branch-alias；类找不到是autoload未生效，需检查PSR-4配置、路径和命名空间一致性。
dev分支写对了但还是 404，先确认 Composer “看不看得见”这个分支
Composer 默认不会主动扫描 Git 仓库的分支列表，它只信任两种来源：Packagist 上已索引的版本，或你项目 composer.json 中显式声明的 repositories。直接写 "vendor/package": "dev-main" 却报错，大概率是因为 Composer 根本没去查那个 Git 仓库。
必须在项目根目录的 composer.json 里加这段（URL 换成你的真实仓库地址）：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/vendor/package.git"
}
]
}
注意：type 必须是 "vcs"，不是 "package" 或漏写；url 要能直连（私有库需配好 SSH key 或 HTTPS token）；改完后要运行 composer update --lock 刷新元数据缓存，不能只靠 install。
分支名大小写、前缀、斜杠，一个字符都不能错
Composer 解析 dev-xxx 时，会严格匹配远程 refs/heads/ 下的原始分支名——它不自动转换、不忽略大小写、不补前缀。
-
dev-main要求远程真有叫main的分支，不是master，也不是MAIN -
dev-feature/login对应远程分支名就是feature/login，不是feature-login或dev/feature/login -
dev-dev/fix是错的：远程分支若叫dev/fix，正确写法是dev-dev/fix（前缀dev-+ 分支名dev/fix），但更推荐统一用dev/fix写法并配"dev/fix"
验证唯一可靠方式是执行：git ls-remote --heads https://github.com/vendor/package.git | grep -i main。没输出 = 分支不存在；有输出如 abc123 refs/heads/main = 存在且可用。
分支存在但 composer show 不显示，可能是缺 branch-alias 或稳定性限制
composer show vendor/package 查不到 dev-main，不代表它装不上；但若连 composer show -a vendor/package 也不列出来，说明 Composer 不认为这是个“可安装版本”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
原因有两个：
- 远程包的
composer.json没设"extra": {"branch-alias": {"dev-main": "1.0.x-dev"}}，Composer 默认不把开发分支当有效版本源 - 你项目
composer.json的minimum-stability是默认的"stable"，它直接过滤掉所有dev-前缀版本
临时解法（推荐）：composer require vendor/package:dev-main@dev —— @dev 后缀强制允许该包走不稳定通道，不影响其他依赖。
别全局改 minimum-stability 到 dev，否则所有包都可能升到不兼容的 dev 版本，CI 极易崩。
装上了但类找不到，和分支无关，是 autoload 配置没生效
分支拉下来了，vendor/package/ 目录里文件也齐全，但 new 一个类就报 Class not found？这不是分支问题，是自动加载没注册进去。
立刻做三件事：
- 运行
composer dump-autoload -v，盯住输出里有没有扫到你的目标命名空间（比如Adding PSR-4 autoload rule for MyLib: src/） - 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如'MyLib\'），确认路径指向正确目录 - 检查类文件路径、
namespace声明、文件名三者是否完全一致：比如MyLibHttpClient必须对应src/Http/Client.php，namespace MyLibHttp;，且目录名大小写精确匹配
常见坑：PSR-4 配置末尾少反斜杠（"MyLib": "src" ❌ 应为 "MyLib\": "src/"），或文件被 .gitignore 忽略导致 dump-autoload 跳过。
