需在 composer.json 的 repositories 中添加 type: "composer" 的私有仓库 url，并配置认证；私有包自身须正确定义 autoload；排查网络、证书、同步状态及缓存问题。
怎么让 Composer 找到私有 Packagist 仓库
Composer 默认只认 packagist.org，要拉你自己的私有包，必须显式告诉它“还有个仓库在这”。不是改 composer.json 里某个包的 dist 地址就行——那是单包临时绕过方案，不解决根本问题。
核心动作是往项目或全局的 composer.json 里加一个 repositories 配置项，类型设为 composer，并指向你的私有仓库根 URL（比如 https://packagist.example.com）。
- 必须用
type: "composer"，别写成"vcs"或漏掉type字段，否则 Composer 不识别为 Packagist 兼容源 - URL 必须能直接访问到
packages.json（通常由私有 Packagist 服务自动生成），浏览器打开https://packagist.example.com/packages.json应返回合法 JSON - 如果私有仓库启用了认证（如 Basic Auth），得提前在本地运行
composer config -g http-basic.packagist.example.com username password，否则后续 install/update 会卡住
为什么 vendor/autoload.php 里没加载私有包的类
不是仓库配对了就万事大吉。Composer 能下载包，不代表自动加载规则生效——尤其当私有包没正确定义 autoload 段时。
检查私有包自身的 composer.json：它必须包含有效的 autoload 声明，比如 "psr-4": {"MyCompany\": "src/"}。如果只写了 "files": ["functions.php"] 却忘了加 "psr-4"，而你的代码又按命名空间引用，就会报 Class not found。
- 私有包发布前务必运行
composer dump-autoload --no-dev测试生成的vendor/composer/autoload_psr4.php是否真包含了你的映射 - 如果私有包是纯函数库（无命名空间），确保调用方已
require了vendor/autoload.php，且该文件确实触发了files加载逻辑 - 注意 Composer 版本差异：2.x 对
autoload-dev的处理更严格，开发依赖里的自动加载不会进生产 autoload 文件
composer update 报错 “Could not fetch packages.json”
典型网络或权限问题，但错误信息太笼统，容易误判为仓库地址写错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
先手动 curl 测试：运行 curl -v https://packagist.example.com/packages.json，看是否返回 200 + JSON 内容。常见真实原因有三个：
- 私有 Packagist 服务未启用 HTTPS 重定向，而 Composer 3.0+ 强制走 HTTPS，此时 URL 写成
http://会被拒绝 - 服务器启用了 IP 白名单，但你的开发机或 CI 机器不在白名单内，curl 会卡住或返回 403
- 私有仓库用了自签名证书，而 Composer 运行环境（如 Docker 容器）没装对应 CA，需额外配置
composer config -g secure-http false（仅限内网可信环境）
私有包版本号不生效，总是拉 latest
私有 Packagist 不是魔法盒，它不会自动猜版本。你 push 到 Git 的 tag（如 v1.2.3）必须被私有 Packagist 正确索引，否则 Composer 看不到那个版本。
确认两点：一是私有 Packagist 的同步任务是否跑成功（查后台日志或 Web UI 的 package 页面，看版本列表有没有 v1.2.3）；二是项目中 require 的版本约束是否写对，比如写成了 "mycompany/utils": "^1.2"，但私有包实际只有 v1.2.0 和 v1.3.0，中间缺 v1.2.1 就可能 fallback 到 dev-main。
- 私有 Packagist 的 “update on push” 功能未必默认开启，有些需要手动点击 “Update” 或配置 webhook
- Composer 缓存很顽固，换版本后先清缓存：
composer clear-cache，再composer update mycompany/utils - 如果私有包用的是
dev-master这种不稳定分支名，记得在项目composer.json里加"minimum-stability": "dev"，否则 Composer 直接忽略
私有 Packagist 最容易卡住的地方，其实是仓库服务本身的状态同步和 Composer 客户端的缓存行为——这两者不透明，但比配置语法更容易让人反复折腾。
