Composer中文镜像环境下Composer清理历史缓存的脚本-composer-PHP中文网

Composer清理缓存前应先确认镜像配置是否生效，若composer config -g repo.packagist未正确设置国内镜像（如阿里、腾讯），则清缓存无效；composer clear-cache已覆盖全部缓存路径，无需手动删除文件。

composer中文镜像环境下composer清理历史缓存的脚本

Composer清理缓存前先确认镜像配置是否生效

很多用户执行 composer clear-cache 后发现下载还是慢，其实问题不在缓存，而在镜像没真正生效。清理缓存本身不解决源地址错误的问题。

先验证当前镜像设置：运行 composer config -g repo.packagist，如果输出是 {"type": "composer", "url": "https://packagist.org"} 或为空，说明全局镜像没配好，清理缓存也没用。

国内常用镜像（如阿里、腾讯、华为）必须通过 composer config -g repo.packagist 显式设置为对象形式，不能只设 packagist.org 为 false
若用 composer config -g repos.packagist 配置，注意键名是 repos.packagist（复数），不是 repo.packagist（单数），拼错会导致配置被忽略
配置后建议运行 composer show -p 查看实际生效的仓库列表，确认镜像 URL 出现在第一行

直接执行 `composer clear-cache` 就够了

Composer 自带的缓存清理命令已覆盖全部历史缓存路径，无需手动删文件或写脚本。所谓“清理历史缓存”，本质就是清空 COMPOSER_HOME/cache 下的 files/、repo/、downloads/ 等子目录，而 clear-cache 正是做这件事。

执行 composer clear-cache 会清掉所有类型缓存：包元数据（repo）、压缩包（downloads）、解压后文件（files）
加 -v 参数可看到具体清理了哪些路径，例如：Clearing cache (C:\Users\xxx\AppData\Roaming\Composer\cache)
不需要额外加 --no-plugins 或 --no-scripts，缓存清理不触发插件或脚本
若提示 Permission denied，说明某些缓存文件被其他进程（如 IDE、终端后台任务）占用，关掉 PhpStorm / VS Code 的 Composer 监控插件再试

需要批量清理或自动化时才写脚本

只有在 CI/CD 流程、Docker 构建或多项目维护场景下，才值得封装成脚本。日常开发没必要。

一个安全、跨平台的最小化清理脚本示例（保存为 clear-composer-cache.sh 或 clear-composer-cache.bat）：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

#!/bin/bash
# Linux/macOS 版
if command -v composer > /dev/null; then
  echo "Clearing Composer cache..."
  composer clear-cache --no-interaction 2>&1 | grep -v "Cache is not cleared"
  echo "Done."
else
  echo "Composer not found."
fi

Windows 批处理版只需把 composer clear-cache --no-interaction 单独一行即可，--no-interaction 防止卡在确认提示。

脚本里不要用 rm -rf ~/.composer/cache 这类硬删路径的方式——COMPOSER_HOME 可能被自定义，且 Composer 未来可能调整缓存结构
避免在脚本中重复设置镜像，清理缓存和镜像配置无关；镜像应在初始化阶段一次性配好
CI 环境中建议加 || true 防止缓存为空时报错退出（虽然 clear-cache 本身不会因为空缓存失败，但某些旧版本有异常）

缓存清理后首次安装仍慢？那不是缓存的问题

清完缓存第一次 composer install 慢，99% 是因为 Composer 要重新 fetch 元数据并校验 hash，跟镜像响应速度、网络稳定性、PHP 版本对 TLS 的支持程度有关，和本地缓存无关。

检查是否启用了 composer config -g github-protocols https，SSH 协议在某些内网环境会超时
PHP 7.2+ 用户注意：部分国产镜像（如华为）要求 TLS 1.2+，若 PHP 编译时 OpenSSL 版本太低，会 fallback 到 packagist.org
composer install 加 -v 可看到每个包是从哪个 URL 下载的，确认是否真走的是镜像域名

缓存本身不存储“下载快慢”的状态，它只存结果。慢，一定是网络链路或服务端的问题，不是你本地多删了一个文件夹就能解决的。