composer 在国内必须配置镜像源，否则因 dns、tls、cdn 等问题在加载仓库阶段卡死或报错；配置需严格遵循键名、type、https 末尾斜杠等规则，并验证是否生效；全局配置受用户权限影响，项目级配置更可靠；临时换源需配合 -vvv 查看真实请求。
不配镜像，Composer 在国内基本跑不起来——不是慢，是大概率卡死或报错。 直连 packagist.org 会因 DNS 解析慢、TLS 握手失败、CDN 缺失等问题，在 Loading composer repositories 阶段卡住数分钟，甚至直接返回 could not find package 或 503 Service Unavailable。这不是你网络差，是物理和政策层面的不可达。
composer config -g repo.packagist 命令总不生效？检查这三处硬伤
这条命令静默失败率极高，且不报错，结果就是你以为配好了，其实还在直连海外源。
-
repo.packagist键名不能写成repos.packagist（多一个s就完全失效） - 中间的
composer是type值，必须显式写出，漏掉就当没执行 - URL 必须是 HTTPS + 末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
验证是否真写进去了：运行 composer config -g repo.packagist。输出应为完整 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）或至少是该 URL 字符串。如果为空、null、或仍是 https://packagist.org，说明配置根本没落盘。
宝塔、CI、Docker 里全局配置为啥不生效
全局配置写在 ~/.composer/config.json，但「谁在跑命令」决定读哪个文件。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你在终端用
root执行了composer config -g，但宝塔后台的「一键部署」是以www用户身份运行的，它读的是/home/www/.composer/config.json，根本看不到root的配置 - CI 脚本里用了
sudo composer config -g，结果写进了root的配置，而构建容器里实际用的是runner用户，照样失效 - 解决办法：切到对应用户下执行，例如
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置更可靠，但别手动改 composer.json
团队协作或 CI 场景下，把镜像源写进 composer.json 才是真正可复现、可提交、可审计的做法。
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 这条命令会自动往
repositories字段安全追加，不覆盖已有私有源；如果原"repositories": {}是空对象，它会转成标准数组并插入；如果是"repositories": []，命令会报错，得先手动改成对象 - 千万别手写
"packagist": false——这会彻底关掉基础包校验，导致php、ext-json等平台依赖无法验证，composer install直接失败
改完后必须删掉 vendor/ 和 composer.lock，再重新 composer install，否则旧 lock 文件里的哈希值可能与镜像元数据不匹配，引发签名错误。
--repository-url 临时换源适合排查，但要加 -vvv 看真实请求
不想动任何配置，又想快速验证某个镜像是否可用？用 --repository-url 参数只对当次命令生效，优先级最高。
- 例如：
composer create-project topthink/think tp-demo --repository-url=https://mirrors.tuna.tsinghua.edu.cn/composer/ - 但光执行不行，必须加
-vvv才能看到真实请求的 URL：composer update -vvv --repository-url=https://mirrors.cloud.tencent.com/composer/ -
-vvv日志里会打印出类似Downloading https://mirrors.cloud.tencent.com/composer/p2/topthink/think.json的行，这才是你当前真正走的源
镜像不是“加速下载 ZIP 包”这么简单，它必须同时替换元数据接口和 ZIP 分发节点。两者不匹配，就会出现 Package not found 或 Signature mismatch——这种问题往往藏在日志最底层，不看 -vvv 根本发现不了。
