根本原因不是命令写错，而是Composer 2.x+已废弃repo.packagist全局配置，仅认repositories.packagist.org或环境变量COMPOSER_REPO_PACKAGIST；旧键名被静默忽略，且项目级repositories或证书缺失也会导致失效。
为什么 composer config -g repo.packagist 不生效
根本原因不是命令写错，而是 Composer 从 2.0 开始彻底废弃了全局镜像配置方式。执行 composer config -g repo.packagist 看似成功，但实际不会影响任何后续安装行为——因为新版本只认 packagist.org 的硬编码逻辑，不再读取该配置项。
常见错误现象：
• 执行完命令后 composer install 依然直连 packagist.org
• composer config -g repo.packagist 返回空值或旧值，但改了也没用
• 某些老旧教程说“加 -g 就行”，结果白忙活
- Composer 1.x 支持该配置，但官方已停止维护，不建议降级
- 2.x 及以上必须用
repositories覆盖（项目级）或环境变量（全局级） - 镜像地址必须带协议（
https://），缺了会报Invalid repository type
如何正确设置国内镜像（Composer 2.x）
唯一可靠的方式是覆盖默认仓库：在项目根目录的 composer.json 中显式声明 repositories，或通过环境变量统一控制。
项目级推荐（最稳定）：
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
],
"packagist.org": false
}
注意："packagist.org": false 必须加上，否则 Composer 仍会回退到官方源；url 值不能末尾多斜杠（如 https://mirrors.aliyun.com/composer// 会失败）。
- 执行
composer update --lock后，composer.lock里的packages条目才会真正走镜像 - 如果已有
composer.lock，先删掉再composer install，否则可能沿用旧源记录 - 阿里云、腾讯云、华为云镜像均支持 HTTPS，但清华镜像（
https://packagist.phpcomposer.com）已停用，别再填
全局镜像怎么设（不用每个项目改）
靠环境变量 COMPOSER_REPO_PACKAGIST，它优先级高于 composer.json 里的 repositories，且对所有项目生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
Linux/macOS（写入 ~/.bashrc 或 ~/.zshrc）：
export COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/
Windows（PowerShell）：
$env:COMPOSER_REPO_PACKAGIST="https://mirrors.aliyun.com/composer/"
设置后重启终端，运行 composer config --list | grep packagist 应显示该 URL。
- 环境变量方式不依赖项目配置，适合 CI/CD 或开发机统一管理
- 若同时存在环境变量 +
composer.json配置，以环境变量为准 - 某些 Docker 镜像（如
php:8-cli）默认没设该变量，需在Dockerfile中ENV显式声明
为什么 composer diagnose 还提示 “You are running Composer with SSL/TLS protection disabled”
这不是镜像问题，而是本地 CA 证书缺失导致 HTTPS 请求失败，进而让 Composer 自动降级尝试 HTTP（被多数镜像站拒绝），最终表现为“镜像无效”。
典型表现：
• composer install 卡在 Loading composer repositories with package information
• 报错含 cURL error 60 或 SSL certificate problem
• curl -I https://mirrors.aliyun.com/composer/ 能通，但 Composer 不行
- Linux：安装
ca-certificates包（apt-get install -y ca-certificates） - macOS：重装 OpenSSL 并更新证书（
brew install openssl && brew link --force openssl） - Windows：确保 PHP 使用的是系统 OpenSSL，而非自带的旧版；检查
php.ini中openssl.cafile是否指向有效证书路径
证书问题不解决，再换十个镜像地址都一样慢或失败。
