镜像还原失败主因是删错字段名（应删repos.packagist而非repo.packagist）或未清缓存；还需排查项目级repositories配置、环境变量及缓存目录权限问题。
镜像还原失败，90% 是因为删错了字段名或没清缓存，不是命令没跑成功。
删错字段名：repos.packagist 和 repo.packagist 不是一回事
Composer 2.x 全局配置里真正起作用的是 repos.packagist（复数、带 s），但很多教程和镜像文档写的是 repo.packagist（单数）。这两个字段在配置文件里可以同时存在，互不干扰。
- 执行
composer config -g --unset repo.packagist→ 白忙，repos.packagist还在生效 - 正确命令必须是：
composer config -g --unset repos.packagist - 验证是否删干净：
composer config -g repos.packagist应输出Key "repos.packagist" does not exist或直接为空 - 如果两个都设过，得分别删：
composer config -g --unset repo.packagist和composer config -g --unset repos.packagist
删了配置但还是走镜像：三层覆盖关系没理清
Composer 查源顺序是：环境变量 > 当前项目 composer.json 中的 repositories > 全局配置。删了全局，项目里还留着，照样优先用。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查项目级配置：
grep -A 5 '"repositories"' composer.json（Linux/macOS）或直接打开composer.json搜索repositories - 查环境变量：
echo $COMPOSER_REPO_PACKAGIST（Linux/macOS）或echo %COMPOSER_REPO_PACKAGIST%（Windows） - 项目里若写了
"packagist.org": false，等于关掉默认源又没给替代源，删全局毫无意义，必须手动编辑composer.json删除整个repositories块 - 临时绕过项目配置：
composer config repo.packagist composer https://repo.packagist.org（不加-g）
清缓存不是可选动作，而是还原生效的前提
即使配置删干净了，旧缓存里的 p/provider-*.json 文件仍含失效镜像地址，Composer 会继续尝试请求这些已死链接，导致 require 或 update 仍报 404 或超时。
- 必须先运行：
composer clear-cache - 验证是否真清掉：
composer require monolog/monolog --no-install -vvv，观察日志中Downloading行的 URL —— 正确应为https://repo.packagist.org，不是任何镜像域名 - 如果仍见
mirrors.aliyun.com，说明某层配置或缓存仍有残留，别跳步 - Windows 用户若提示
Permission denied，可能是杀毒软件锁了%APPDATA%\Roaming\Composer\config.json，需管理员权限运行终端
权限问题会伪装成“镜像还原失败”
当 ~/.composer/cache 或系统临时目录（如 /tmp、sys_temp_dir）属主是 root，Composer 可能无法读取新缓存，导致它悄悄 fallback 到旧镜像路径，看起来就像“还原没生效”。
- 检查缓存归属：
ls -ld $(composer config --global cache-dir)，若属主不是当前用户，就坐实了 - 安全修复：
sudo chown -R $USER:$USER $(composer config --global cache-dir)，不要用chmod -R 777 - 查 PHP 实际用的临时目录：
php -i | grep "sys_temp_dir"，若指向受限路径（如 Windows 下带空格的AppData子目录），优先在 shell 里设置：export TMPDIR="$HOME/tmp" && mkdir -p "$HOME/tmp" - PHPStudy/XAMPP 等集成环境常在此处埋坑，建议用官方 PHP CLI 模式验证是否真由镜像配置引起
