镜像源配不生效需检查三个硬性条件：键名必须为repo.packagist（单数）、type值必须显式写composer、URL末尾必须带/，缺一即静默失效；验证命令composer config -g repo.packagist应输出完整JSON对象，否则配置未生效。
镜像源配不生效？检查三个硬性条件
镜像源配置失败，90% 是因为 composer config -g repo.packagist 命令漏了关键参数或写错字段名。它不是“设个 URL 就完事”，必须同时满足三项：
-
repo.packagist（单数，不能是repos.packagist或repository.packagist） - type 值显式写
composer（不是可选，缺了就 fallback 到 packagist.org） - URL 必须以
/结尾（例如https://mirrors.aliyun.com/composer/，少斜杠会拼出错误路径）
验证是否生效：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回 null、空值或报错，说明没写对。
缓存目录权限不对，Composer 会静默退回到默认路径
你设了 COMPOSER_CACHE_DIR 或用 composer config --global cache-dir，但 composer install 还在往 ~/.composer/cache 写——大概率是新路径权限不足。Composer 不报错，而是悄悄降级使用默认路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确认当前实际生效路径：
composer global show -v | grep "Cache directory" - 检查该路径归属：
ls -ld $(composer config --global cache-dir)，第三列（属主）必须是你当前用户（$(whoami)），不能是root或www-data - 修复命令：
sudo chown -R $USER:$USER /path/to/your/cache（别用chmod -R 777，那是掩耳盗铃） - 特别注意 WSL、Docker bind mount、macOS 外接 NTFS 盘：这些场景下
chown可能无效，得换挂载方式或改用容器内 UID 映射
CI/CD 中缓存失效的常见陷阱
GitHub Actions 或 Jenkins 里设了 COMPOSER_CACHE_DIR 却每次重下包，问题不在镜像，而在缓存没真正持久化。
- Docker 场景必须显式挂载：
docker run -e COMPOSER_CACHE_DIR=/cache -v $(pwd)/cache:/cache ...，否则容器退出后缓存清零 - GitHub Actions 的
actions/cache要缓存的是$HOME/.composer/cache或你自定义的路径，不是vendor/；且 key 要包含 PHP 版本和 Composer 版本（如php-${{ matrix.php-version }}-composer-${{ matrix.composer-version }}），避免不同版本混用导致 autoload 错乱 - 某些 CI 脚本习惯执行
rm -rf ~/.composer清理，如果你用了COMPOSER_CACHE_DIR指向别处，这个清理就失效了——得同步更新清理逻辑
缓存 + 镜像，谁管什么？别指望镜像解决本地缓存问题
换阿里云镜像后还是慢，不是镜像不行，而是你误以为“换源 = 自动启用缓存”。两者职责完全不同：
- 镜像源只改远程请求地址（
packages.json和 dist 包下载走哪条路） - 缓存目录决定
.zip包、repo/元数据、archived/文件存哪，是否复用 - 即使镜像飞快，首次安装仍要下载；第二次才靠缓存跳过下载。若缓存路径不可写、被禁用（
"config": {"cache-dir": false}）、或用了--no-cache，镜像再快也没用 - 验证缓存是否起效：跑一次
composer clear-cache，再composer install，观察 verbose 日志里是否有Downloading https://...；第二次再跑，如果还有下载日志，说明缓存没命中
最常被忽略的一点：缓存目录路径里不能含空格，COMPOSER_CACHE_DIR="/mnt/my cache" 会失败——要么用符号链接绕过，要么换无空格路径。
