如何清理Composer的缓存？（clear-cache命令指南）

运行 composer clear-cache 可清空全部缓存文件，缓存路径因系统而异：macos/linux 为 ~/.composer/cache，windows 为 %appDATA%Composercache；清理不影响已安装项目。

直接运行 composer clear-cache 就能清空 Composer 的全部缓存文件，这是最常用也最有效的方式。

缓存位置在哪？

Composer 缓存默认存在本地用户目录下，具体路径因系统而异：

• macOS / Linux：~/.composer/cache
• windows：%APPDATA%Composercache（通常是 C:Users用户名AppDataRoamingComposercache）

执行 clear-cache 命令后，这些目录里的 repo、files、vcs 等子目录都会被清空，但不会删除 config.json 或全局配置。

什么时候该清理缓存？

以下情况建议手动清缓存：

星绘

豆包旗下 AI 写真、P 图、换装和视频生成

404

查看详情

• 安装包时提示 “package not found” 或版本信息明显过时
• 切换了镜像源（比如从 packagist.org 切到阿里云镜像），但 composer 仍拉取旧地址的元数据
• 磁盘空间告急，发现 ~/.composer/cache 占用几个 GB
• 升级 Composer 后出现依赖解析异常，怀疑缓存不兼容

清理后会影响已安装项目吗？

完全不影响。缓存只是 Composer 下载和解析过程中的临时副本，所有已安装在项目里的 vendor 文件、锁文件（composer.lock）、自动加载映射都保持原样。下次运行 composer install 或 composer update 时会重新下载并重建缓存。

其他相关操作

如果想更精细地控制，也可以：

• 只清包源缓存：composer clear-cache --no-interaction（跳过确认提示）
• 查看缓存大小：composer show --profile 末尾会显示缓存占用
• 禁用缓存（调试用）：composer install --no-cache，本次命令不读写缓存

不复杂但容易忽略。