Composer配置镜像不生效的主因是键名写错（如repos.packagist）、漏掉type值（必须为composer）、URL末尾缺/，导致静默回退至packagist.org；验证需执行composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
Ubuntu 上配 Composer 中文镜像，不是改个 URL 就完事——repo.packagist 键名写错、type 值漏掉、URL 少个 /，全都会静默 fallback 到 packagist.org，你根本看不出问题。
composer config -g repo.packagist 为什么总不生效
这条命令看着成功，但 composer install -vvv 日志里还在请求 https://packagist.org？大概率是三个硬伤之一：
-
repo.packagist写成repos.packagist（多一个 s）或mirror：Composer 2.x 直接忽略，不报错也不写入 - 没指定
type值，比如执行的是composer config -g repo.packagist https://mirrors.aliyun.com/composer/：缺composer这个 type 参数，配置被跳过 - URL 少了末尾
/，例如https://mirrors.aliyun.com/composer：请求会拼成/composerpackages.json，返回 404，Composer 自动退回到官方源
验证是否真写进去了：composer config -g repo.packagist 必须输出完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没写进去。
全局配置 vs 项目级配置：哪个更靠谱
全局配置（-g）只影响你当前 shell 用户，CI/CD 流水线、宝塔后台（www 用户）、Docker 容器里全都不认；项目级配置才真正可靠：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带-g） - 它会自动把配置写进
composer.json的repositories字段，key 固定为"packagist" - 如果
composer.json里repositories是数组[]，命令会失败——得先手动改成对象{}再执行 - 项目级配置优先级高于全局，哪怕你本地配好了全局，只要
composer.json有repositories，就完全按它来
换源后还是卡在 “Loading composer repositories”
镜像只改下载地址，不清理旧缓存和 lock 文件，Composer 仍会拿着 packagist.org 的 hash 去校验新源的数据，必然失败：
- 先清缓存：
composer clear-cache - 删掉
vendor/和composer.lock - 再跑
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或mirro（注意不是packagist.org） - 如果还卡住，检查 PHP 是否启用了
zip、phar、mbstring、xml、curl扩展——缺任意一个，Composer 解包或解析元数据都会挂
Ubuntu 系统 PATH 和权限常见坑
装完 composer 命令找不到？不是没装，是路径或权限不对：
- 官方脚本安装后，必须执行
sudo chmod +x /usr/local/bin/composer，否则 Permission denied - 确认
/usr/local/bin在$PATH里：echo $PATH，没有就加到~/.bashrc或~/.zshrc - 全局命令（如
laravel/installer）的二进制文件放在~/.composer/vendor/bin/，这个路径也得手动加进PATH - 用 systemd 或宝塔部署时，Web 进程常以
www-data或www用户运行，得切换用户配镜像：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
镜像配置本身很简单，但每个环节都卡在细节上：键名大小写、斜杠有无、用户上下文、缓存残留——漏掉任何一个，你就还在原地等 packagist.org 的 DNS 解析超时。
