根本原因是键名、type值或url格式错误导致composer静默忽略配置；键名必须为repo.packagist（单数），type值必须为composer且不可省略，url须以/结尾，且必须加-g参数写入全局配置。
composer config -g repo.packagist 命令为什么没生效
根本原因通常是键名、type值或URL格式三者之一出错，而Composer不报错，直接静默忽略配置。
常见错误现象：命令执行无报错，composer config -g repo.packagist 输出为空或仍是 https://packagist.org；composer install -vvv 日志里持续出现 Downloading https://packagist.org/。
- 键名必须是
repo.packagist（单数，不是repos.packagist或repository.packagist） - 中间的
composer是 type 值，不能省略，也不能写成package、composer-type等 - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/，少斜杠会导致请求拼接成/composerpackages.json，返回 404 后自动 fallback 到官方源 - 必须加
-g参数，漏掉就只写进当前项目级配置，反而可能覆盖全局设置
删镜像时别用 composer config --unset repos
这条命令会清空整个 repositories 对象，包括你手动添加的私有仓库、GitHub 源、自建包源——不是删镜像，是删所有源。
正确做法永远指向具体子键：
- 删全局阿里云镜像：
composer config --global --unset repos.packagist.org（Composer 2.x 推荐）或composer config --global --unset repo.packagist（Composer 1.x 兼容） - 删项目级镜像：
composer config --unset repos.packagist.org，再手动检查composer.json是否残留"repositories"字段 - Windows 用户在 cmd 下执行时，
.可能被误解析为路径分隔符，建议改用 PowerShell 或 WSL
composer clear-cache 为什么清了还走旧镜像
缓存清理本身不改变配置逻辑，只强制重新拉取元数据。如果配置没生效，清缓存毫无作用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
先确认镜像是否真已写入：
- 运行
composer config -g repo.packagist，输出应为完整 URL 或 JSON 对象，不含packagist.org - 执行
composer clear-cache --dry-run查看将清理的路径，确保它指向你预期的缓存目录（如~/.composer/cache） - CI 环境下必须加
--no-interaction，否则卡在交互确认；若仍卡住，可能是其他进程锁着缓存目录（Linux/macOS 用lsof +D $(composer config --global cache-dir)查） -
vcs/目录默认不被clear-cache清理，但单个 Git 裸仓库常占 300–800 MB，需手动删：rm -rf ~/.composer/cache/vcs/*（Linux/macOS）或rd /s /q "%APPDATA%\Composer\Cache\vcs"（Windows）
项目级 repositories 字段会彻底覆盖全局镜像
这是最常被忽略的优先级陷阱：只要 composer.json 顶层存在 "repositories"，无论内容是否为空、是否含 "packagist.org": false，全局镜像都会失效。
验证与修复步骤：
- 运行
composer config --list | grep repositories，若输出含项目路径，说明composer.json里写了该字段 - 打开
composer.json，搜索repositories，删掉整块（包括"repositories": {}这种空对象） - 删完后跑
composer update --dry-run -vvv 2>&1 | grep -i "mirrors\|packagist"，观察日志域名是否已切回镜像地址 - 临时绕过验证：
composer install --no-plugins --repository=https://packagist.org，如果这时变快，就坐实是项目配置劫持
复杂点在于，有些 Laravel 脚手架模板或 CI 构建产物会硬编码 repositories，首次 create-project 就卡住——这种情况下得加 --repository-url= 参数临时指定源，而不是指望全局配置。
