pinset
EN
清理

pinset clean cache

清理不再被项目或恢复记录引用的下载缓存,释放磁盘空间。

在 GitHub 查看源文档 ↗

什么时候用

下载缓存占用过多时使用,不删除已安装工具;旧工具用 clean installs。

示例

pinset clean cache --plan
pinset clean cache

执行结果:先列出可删和保留对象,再删除无引用缓存。预览的 removed 是计划删除路径,尚未实际删除。

行为细节

保护已登记项目、全局锁、venv 和未完成事务的引用,不确定对象保留。不联网、不改选择。仅删除受管缓存内安全对象;仍有引用的缓存留给离线还原。

参数、退出码与常见错误

参数含义
--plan只列候选和保留项。

成功返回 0,失败返回 1。PINSET_CLEAN_UNSAFE 需检查路径;uncertain_references: true 表示保守保留,不是清理失败。

/docs/commands/clean-cache适用版本 · Pinset 3.1.0