Composer install 报错90%非代码问题，需先确认缓存真实路径、验证镜像三要素（repo.packagist、type="composer"、HTTPS且以/结尾）、检查属主与inode，再执行clear-cache、删vendor、加--no-cache强制重装。
拉取代码后 composer install 报错，90% 不是代码问题，而是本地缓存残留或镜像未生效——直接跑 composer clear-cache 往往不够，得配合路径确认、镜像验证和强制重装。
为什么 composer clear-cache 有时没用
它只清 composer config --global cache-dir 返回的目录，但这个路径可能被 COMPOSER_CACHE_DIR 环境变量覆盖（比如 CI 中挂载到 NFS），清错地方等于白干。更常见的是：缓存清了，但镜像配置根本没生效，composer install 还是默默回退到 packagist.org，结果继续 404 或超时。
- 先查真实路径：
composer config --global cache-dir - 再看大小：Linux/macOS 执行
du -sh $(composer config --global cache-dir)；Windows 直接打开资源管理器，粘贴%APPDATA%\Composer\Cache查属性 - 不到 200 MB 别急着清；超 1.5 GB 且半年没碰老项目，才值得动手
- 如果路径显示
/mnt/nfs/composer-cache，说明缓存不在本地，清它可能影响其他构建节点
repo.packagist 配置必须三要素齐全
镜像不生效不是缓存问题，而是配置写错了——Composer 2.x 对格式零容忍，漏一个就静默 fallback。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须是
repo.packagist（单数），不是repos.packagist或repositories -
type值必须显式为"composer"，不能省略，也不能写成composer-type -
url必须是 HTTPS 且以/结尾，例如https://mirrors.aliyun.com/composer/（少斜杠会拼出/composerpackages.json，直接 404） - 验证是否真生效：别信
composer config -g repo.packagist的输出，它只告诉你“写了什么”。要跑composer install -vvv，看日志里出现的是镜像地址还是packagist.org
报 corrupted archive 或卡在 Resolving dependencies 怎么办
前者是缓存 ZIP 损坏，后者是 SAT 回溯陷入死循环——这时候光清缓存不够，得切断所有缓存路径并绕过校验逻辑。
- 先执行
composer clear-cache，再手动进缓存目录确认files/和repo/子目录为空 - 强制重装三步：删
vendor/+ 清缓存 + 加--no-cache参数 - 关键命令（Windows/Linux 通用）：
composer install --no-cache --prefer-dist --optimize-autoloader --no-dev - 其中
--no-cache是核心：它禁用本次所有缓存查找，确保每个包都重新下载；--prefer-dist避免触发 Git clone；--no-dev跳过开发依赖，大幅缩短解析时间 - 若仍卡在 SAT，用
composer why-not vendor/package:version定位阻断链，比等它穷举快得多
权限错误和 inode 耗尽常被忽略
Permission denied 或 No space left on device 很少是磁盘真满了，大概率是属主混乱或 inode 被 vcs/ 目录吃光。
- 如果曾用
sudo composer，缓存子目录属主可能变成root，普通用户运行clear-cache会失败。修复命令：sudo chown -R $USER:$USER ~/.composer/cache（Linux/macOS）或icacls "%APPDATA%\Composer\Cache" /grant %USERNAME%:F /t（Windows） -
vcs/目录默认被clear-cache跳过，但单个 Git 裸仓库能占 300–800 MB 且耗尽 inode。手动清理：rm -rf ~/.composer/cache/vcs/*（Linux/macOS）或rd /s /q "%APPDATA%\Composer\Cache\vcs"（Windows） - 长期策略：禁用 VCS 缓存，
composer config --global cache.vcs false，后续所有 Git 包自动走--prefer-dist
真正卡住的时候，别纠结“该不该清”，先确认缓存路径、验证镜像配置、检查属主和 inode——这些点错一个，后面所有操作都是在原地打转。
