全局配置仅在项目未声明repositories时生效，否则被项目级配置覆盖；正确配置需严格遵循参数位置、大小写、结尾斜杠等规则，推荐项目级配置并提交至git。
全局配置只在项目没声明 repositories 时才起作用，否则直接被忽略——这不是 bug，是 Composer 的明确设计逻辑。
为什么 composer config -g repo.packagist 总像没生效
根本不是命令没跑，而是它被项目级配置“盖住了”。只要当前目录下 composer.json 里有 "repositories" 字段（哪怕内容是空数组 [] 或只写了 {"packagist": false}），Composer 就会跳过全局设置，完全按项目配置走。
- 检查方法：
grep -A 3 "repositories" composer.json，看是否命中 - 临时验证：进项目目录后执行
composer config --unset repositories，再跑composer diagnose，观察 “Repo” 行是否变成镜像地址 - 注意：
composer config --unset repositories是删整个字段，不是清空值；composer config --unset repositories.packagist才是只删 packagist 子项
composer config 命令里三个位置都不能错
这条命令的每个参数位置都有硬编码语义，写错一个就静默 fallback 到 https://packagist.org，且不报错：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
-g必须存在：漏掉就只改当前项目composer.json，换目录即失效 -
repo.packagist必须单数、全小写、无 s：写成repos.packagist或packagist.org，配置会存进无效字段，查composer config -g repo.packagist输出为空或null -
composer是必需的type值：不是注释，不是可选，漏掉就等于没设 type，Composer 自动退回到默认源 - URL 必须以
/结尾：比如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼路径时变成/composerpackages.json，404）
项目级配置更适合协作与 CI 场景
全局配置看着省事，但在多项目共用一台机器、CI 流水线、宝塔面板或 Docker 构建中，容易因镜像不一致导致 composer.lock hash 不同、依赖安装失败甚至线上行为差异。
- 推荐做法：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令会向
composer.json写入"repositories"字段，提交到 Git 后所有协作者自动统一源 - 如果项目已有自定义
repositories（比如私有包），不要直接覆盖，先手动合并数组，否则丢包 - 提交前检查：
composer.json中新增的repositories是否格式正确、缩进一致、末尾有逗号（避免 JSON 解析失败）
切回官方源不能设空字符串
想恢复默认行为，不是执行 composer config -g repo.packagist ""，那只会存个空 URL，后续请求照样失败。必须用 --unset 显式删除键：
- 全局恢复：
composer config -g --unset repo.packagist - 项目级恢复：
composer config --unset repo.packagist（在项目目录下运行） - 删完立刻执行
composer clear-cache，否则旧元数据缓存还在，composer install仍可能卡住 - 验证是否真回退：
composer config -g repo.packagist应报Key not found；composer diagnose的 “Repo” 行应显示https://packagist.org
真正容易被忽略的是：镜像源只代理元数据（packages.json），不代理 ZIP 包下载地址。所以即使配置全对、composer install 解析飞快，下载阶段仍可能卡在 GitHub —— 那得另配 github-domains 或用 git clone 替代策略，和镜像源本身无关。
