清理
pinset clean installs
删除不再被项目、全局选择或受管 Python 环境引用的工具安装。
在 GitHub 查看源文档 ↗什么时候用
升级后释放旧版本空间时使用。仍被选择的工具先 remove；其他项目引用的安装仍保留。
示例
pinset clean installs node@22.0.0 --plan
pinset clean installs node@22.0.0
执行结果：只删除匹配筛选、安装记录有效且无引用的目录。没有可删对象也可成功。
行为细节
不联网、不改配置或锁。保护登记项目、全局、受管 venv 和恢复记录。外部、无所有权证明或引用不确定的对象保留。省略筛选检查全部受管安装。
参数、退出码与常见错误
| 参数 | 含义 |
|---|---|
[tool@exact...] | 仅检查这些确切版本，不接受 latest、lts 等浮动选择。 |
--plan | 只预览。 |
成功返回 0，失败返回 1。PINSET_EXACT_REQUIRED 需用确切版本；PINSET_CLEAN_UNSAFE 需检查路径，不要手删被引用目录绕过保护。
/docs/commands/clean-installs适用版本 · Pinset 3.1.0