缓存目录权限异常导致 clear-cache 无效，需手动删重建并授权：Linux/macOS执行rm -rf ~/.composer/cache && mkdir -p ~/.composer/cache && chmod 755 ~/.composer/cache；Windows需在%APPDATA%\Composer\Cache中为子目录授予当前用户“完全控制”权限；WSL须避开/mnt/c/路径。
缓存目录权限异常导致 clear-cache 无效
运行 composer clear-cache 后仍复用旧包，常见原因是缓存目录属主或权限错乱——Composer 写入失败但不报错，后续 install/update 仍读取残留文件。
- Linux/macOS：先查路径
composer config --global cache-dir（通常是~/.composer/cache），然后删重建并授权：rm -rf ~/.composer/cache && mkdir -p ~/.composer/cache && chmod 755 ~/.composer/cache - Windows：路径在
%APPDATA%\Composer\Cache，需右键子目录 → 属性 → 安全 → 编辑，确保当前用户有“完全控制” - WSL 用户必须避开
/mnt/c/路径，改用~/projects/等原生 Linux 路径，否则 chmod 和 chown 都是假动作
ZIP 文件损坏引发 Extracting 失败
报 Failed to extract 或 Corrupted zip file，不是网络问题，而是 ~/.composer/cache/files/ 下某个 ZIP 文件结构损坏（如下载中断、磁盘写异常）。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer clear-cache会清空整个files/，但 Composer 在重装时只比对哈希，不验证 ZIP 结构，可能跳过校验直接复用坏包 - 盯住
composer install -v输出末尾，找到类似Extracting vendor/symfony/console的行，提取包名（如symfony/console） - 进缓存
files/目录，模糊搜索并仅删除对应 ZIP：ls -l *symfony*console*.zip（Linux/macOS）或 PowerShell 中Get-ChildItem "$env:APPDATA\Composer\Cache\Files" -Recurse -Filter "*console*.zip" - 别碰
repo/和vcs/目录——它们不参与解压 - 删 ZIP 后若还报错，说明
composer.lock里硬编码的dist.sha256值与新下载内容不匹配，必须同步删掉vendor/和composer.lock
metadata 缓存滞后导致 update 拉不到新版
composer update 显示 “nothing to install or update”，但 Packagist 上已有新版本，大概率是 metadata 缓存未刷新——composer clear-cache 不强制拉取 packages.json，而 Composer 会复用 ~/.composer/cache/repo/https---packagist.org/ 下旧的 provider 映射和索引文件。
- 必须手动删整个 repo 子目录：
rm -rf $(composer config --global cache-dir)/repo/https---packagist.org/ - 同时删掉
vendor/composer/installed.json（当前安装快照）和composer.lock（版本锁定） - 验证是否生效：
composer update --dry-run -v，看到Downloading https://packagist.org/packages.json才算真正从镜像站拉新元数据 - Composer ≥ 2.5 可用
composer update --refresh替代手动删 repo；≤ 2.4 必须手动删
镜像配置失效却还在连 packagist.org
composer update -vvv 日志里仍出现 packagist.org，说明镜像根本没生效——这通常不是缓存问题，而是配置被覆盖或拼写错误。
- Composer ≥ 2.2 键名应为
repos.packagist（复数），写成repo.packagist会被静默忽略 - 项目根目录
composer.json里只要存在"repositories": []（哪怕空数组），全局镜像就彻底失效 - 镜像 URL 缺末尾斜杠：
https://mirrors.aliyun.com/composer会被拼成/composerpackages.json，返回 404 - 企业网络拦截 SNI 或 TLS 1.3 时，可临时关校验：
composer config -g secure-http false（仅调试用）
Failed to extract 看似是网络或包本身问题，实际是本地 ZIP 文件损坏；nothing to install 看似没新包，其实是 metadata 缓存锁死了旧索引。处理前务必先看 -vvv 输出的最后一行，确认卡点在哪一层。 
