🧹 ClearCache

清除 Composer 的下载与元数据缓存。等价于执行 composer clear-cache。

何时使用

当遇到包下载异常、元数据过期，或在 CI 中需要确保从干净状态拉取依赖时使用。也常用于磁盘空间回收场景。

签名

func (c *Composer) ClearCache() error

参数

该方法无参数。

返回值

返回值	类型	说明
唯一返回值	error	清除失败时返回

示例

package main

import (
	"fmt"
	"log"

	"github.com/scagogogo/composer-skills/pkg/composer"
)

func main() {
	comp, err := composer.New(composer.DefaultOptions())
	if err != nil {
		log.Fatalf("初始化失败: %v", err)
	}

	if err := comp.ClearCache(); err != nil {
		log.Fatalf("清除缓存失败: %v", err)
	}
	fmt.Println("Composer 缓存已清除")
}

进阶

• 想在清除前查看缓存目录位置，使用 GetComposerHome 或 GetCacheDir()。
• 该方法只关心退出码，不返回命令文本输出。
• 在自动化流水线中，通常在 Update / Install 失败重试前调用一次以排除缓存污染。