Private Packagist 的 Composer 配置需在项目 composer.json 中显式声明私有源，添加 repositories 字段并设 "packagist.org": false；认证通过 auth.json 提供 API token；包须手动添加且权限正确；依赖公开包建议保留 packagist.org 作为 fallback 源。
Private Packagist 的 Composer 配置怎么写
必须在项目根目录的 composer.json 里显式声明私有源，否则 composer install 根本不会去 Private Packagist 拉包。官方不自动 fallback，也不读全局配置。
- 在
composer.json中添加"repositories"字段，类型为"composer"，URL 填你团队的 Private Packagist 实例地址（如https://your-org.privatepackagist.com） - 必须同时设置
"packagist.org": false在"repositories"顶层，否则 Packagist.org 仍会参与包解析，可能命中同名但非预期的公开包 - 认证靠
auth.json：在项目根目录或COMPOSER_HOME下放auth.json，内容为{"your-org.privatepackagist.com": {"token": "xxx"}}—— 这个 token 是你在 Private Packagist 后台生成的 API Token，不是用户名密码
为什么 composer require 报错 “Could not find package”
常见原因是包名没被 Private Packagist 索引到，或者权限没开。它不像 Packagist.org 自动抓取 public repo，私有包必须手动添加或通过 webhook 同步。
- 确认该包已添加进 Private Packagist 控制台：进入 “Packages” → “Add package”，支持 Git URL 或直接选已连接的 GitHub/GitLab 仓库
- 检查包的
name字段是否和composer require时写的完全一致（包括 vendor 名，大小写敏感） - 确认当前 token 所属用户/组织有该包的读权限 —— Private Packagist 支持 per-package 权限控制，不是加了源就自动可读
- 运行
composer clear-cache再试，有时旧缓存会干扰元数据更新
私有包依赖公开包，会不会冲突
不会自动冲突，但版本约束可能意外覆盖。Private Packagist 默认会代理（proxy）对 packagist.org 的请求，前提是你的源配置里没关掉 "packagist.org": false。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果关闭了 packagist.org，又没把依赖的公开包也手动加进 Private Packagist，
composer update会直接失败 - 推荐保留 packagist.org 作为 fallback：设
"packagist.org": {"type": "composer", "url": "https://packagist.org"}，并确保它排在私有源之后（Composer 按顺序查源） - 注意：某些企业防火墙会拦截 packagist.org，此时需单独配代理或改用镜像，Private Packagist 本身不解决网络可达性问题
composer update 很慢，是不是 Private Packagist 导致的
大概率是元数据同步延迟或未启用 dist 包下载。Private Packagist 默认走 source（git clone），尤其对未打 tag 的 dev 分支，每次都要 fetch 全量历史。
- 确认包已发布正式 release（打了 semantic version tag），Private Packagist 才会生成 dist ZIP；否则强制走 source
- 在 Private Packagist 的 package 设置页，打开 “Enable ZIP archives” 和 “Prefer dist over source”
- 本地执行
composer config -g repos.packagist composer https://packagist.org可恢复全局默认行为，排除私有源干扰做对比测试
真正卡住的地方往往不是 Private Packagist 本身，而是 Git 服务器响应慢、token 权限不足触发多次重试、或者 composer.lock 锁了过期的 commit-ref。别急着调优，先用 composer update -v 看具体卡在哪一步。
