andreafrancia/trash-cli

这是什么？

核心功能

• 01将文件移入与 KDE、GNOME、XFCE 共用的 freedesktop.org 回收站。
• 02为每个条目记录原始路径、删除日期和权限。
• 03交互式还原条目，支持覆盖已有文件和选择范围。
• 04可清空整个回收站，或只清理超过指定天数的条目。
• 05提供 bash、zsh、tcsh 的命令补全。

适用场景

• 在日常终端操作中替代 rm，让误删的文件可以找回。
• 通过 cron 每天清理过期的回收站文件。
• 在脚本或 shell 中查找并还原回收站里的文件。

快速上手

1. 1

   使用 pipx 安装 trash-cli（推荐）

   pipx install trash-cli
2. 2

   或者使用 pip 安装

   pip install trash-cli
3. 3

   将文件移入回收站

   trash-put foo
4. 4

   列出回收站中的文件

   trash-list

使用前须知

• !不支持 Btrfs 卷。
• !功能依赖 freedesktop.org 回收站规范，仅适用于使用该回收站的环境。

标签

常见问题

trash-cli 是什么？

命令行工具，将文件移入 freedesktop.org 回收站，与 KDE、GNOME、XFCE 共用同一回收站。 trash-cli 让你在终端中将文件和目录移入 freedesktop.org 回收站，而不是直接永久删除。每个被移除的条目都会记录原始路径、删除日期和权限，方便之后查找和还原。

trash-cli 可以免费使用吗？用的什么许可证？

trash-cli 以 GPL-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

trash-cli 还在维护吗？

活跃维护中。trash-cli 最近一次提交是在 2026年10月16日。

trash-cli 适合用来做什么？

在日常终端操作中替代 rm，让误删的文件可以找回。 通过 cron 每天清理过期的回收站文件。 在脚本或 shell 中查找并还原回收站里的文件。

trash-cli 怎么安装和运行？

使用 pipx 安装 trash-cli（推荐）: pipx install trash-cli 或者使用 pip 安装: pip install trash-cli 将文件移入回收站: trash-put foo 列出回收站中的文件: trash-list

在哪里获取 trash-cli？

源代码和安装说明在 GitHub 上：https://github.com/andreafrancia/trash-cli