私有包无法安装的根本原因是composer默认优先查询packagist.org，必须在composer.json顶层显式配置"packagist.org": false，并确保私有仓库url以/结尾、类型声明正确。
私有包装不上，八成是仓库优先级或 packagist.org 没关掉；镜像源配不对，根本不会生效——不是 Composer 不认，是你给的配置它直接静默忽略。
为什么加了私有仓库 URL 还是报 Could not find package
根本原因不是 Git 地址写错，而是 Composer 默认仍会先查 packagist.org，你的私有仓库只是 fallback。哪怕 repositories 里写了 Artifactory 或 Satis 地址，只要没显式禁用默认源，私有包就永远不会被匹配。
-
"packagist.org": false必须写在composer.json顶层，不能嵌在repositories数组里 - Artifactory/Satis 镜像 URL 末尾的
/绝对不能省，少一个就 404，Composer 静默回退 - 如果用了虚拟仓库（如 Artifactory Virtual），后端必须至少挂一个
type: composer的本地或远程仓库，Generic类型不兼容 - VCS 仓库（如
"type": "vcs"）不需要关packagist.org，但必须确保包名和版本在该 Git 仓库的composer.json中正确定义
composer config -g repo.packagist 总没反应？
不是命令没执行，是三个硬性条件一错就静默失效：键名必须是 repo.packagist（不能多写 s），type 值必须显式写 composer，URL 必须以 / 结尾。漏掉任意一项，composer config -g repo.packagist 输出就是空或 null，且不报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误示例：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/→ 多了个s，字段存进去了但不生效 - 错误示例：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 缺composer类型，新版直接 fallback 官方源 - 错误示例：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer→ 缺末尾/，请求路径拼成/composerpackages.json，404 后静默回退 - 验证方式：运行
composer config -g repo.packagist，输出应为完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
项目级 repositories 配置怎么避免被覆盖
全局配置在 CI、宝塔、Docker 等多用户场景下极易失效——~/.composer 路径可能根本不存在，或者写到了 runner 用户家目录，而实际执行的是 www 用户。项目级才是稳定解法。
- 执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意没-g），会安全写入当前项目composer.json的repositories字段，只新增"packagist"子项 - 前提是原
repositories是对象（{}），不是数组（[]）；如果已是数组，该命令会失败，需先手动改成空对象再运行 - 项目级配置可提交 Git，团队成员拉代码后行为一致，无需额外环境准备
- 多个仓库共存时，顺序即优先级：私有仓库务必放在
repositories数组最前面，否则同名包会被 Packagist 的高版本覆盖
Satis 静态仓库构建后 composer update 还走外网？
Satis 生成的是纯静态文件，不提供动态 API。如果 composer update 还在连 packagist.org，说明客户端根本没读到你的镜像源——问题一定出在链路中间某处。
- 用
curl -I https://satis.example.com/packages.json验证，必须返回200；Nginx 返回 403 或 404，Composer 就会静默 fallback - 项目
composer.json中的url值必须以/结尾，比如"https://satis.example.com/"，写成"https://satis.example.com"会导致路径拼接错误 - Satis 构建命令中指定的输出目录（如
web/）必须能被 Web 服务器直接访问，且packages.json文件权限可读 - 如果用了 CDN 或反向代理，确认没有缓存
packages.json的旧版本，或强制刷新缓存
真正容易被忽略的点是：仓库类型声明、URL 末尾斜杠、以及 packagist.org 的显式开关——这三者任何一个出错，Composer 都不会报错，只会默默走默认源。调试时别猜，先 curl 看响应码，再看 composer config 输出是否符合预期。
