🗂️ 在 Debian 上安装最新版 superfile

什么是 superfile？

superfile 是一个围绕常开面板设计的终端文件管理器。多个目录并排显示，侧边栏放着家目录快捷方式、置顶文件夹和已挂载的磁盘，预览面板会画出光标当前所在的内容：带语法高亮的源码、纯文本、目录列表，或者一张图片。复制、移动和压缩都在后台进行，并在进程栏里汇报进度，因此大文件传输永远不会卡住你正在浏览的面板。删掉的文件会进回收站，可以再取回来；压缩包就地解压和创建；每一个按键、颜色、边框字符和面板宽度都是 TOML 文件里的一行。它是一个静态链接的 Go 二进制文件，而你敲的命令叫 spf。

⚡ superfile 的主要功能

📦 从 deb.griffo.io 安装

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt update

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update

sudo apt install extrepo
sudo extrepo enable griffo
sudo apt update

# 安装最新版 superfile
sudo apt install superfile

# 可选，给需要它们的插件用：exiftool 用于元数据面板，
# zoxide 用于智能目录跳转
sudo apt install libimage-exiftool-perl zoxide

# 验证安装，命令是 spf，不是 superfile
spf --version

# 安装最新版 superfile
apt install superfile

# 可选，给需要它们的插件用：exiftool 用于元数据面板，
# zoxide 用于智能目录跳转
apt install libimage-exiftool-perl zoxide

# 验证安装，命令是 spf，不是 superfile
spf --version

# 打开你所在的目录
spf

# 或者从别的地方开始
spf ~/Downloads

# 命令行上给两个路径，就是两个面板
spf ~/src ~/Downloads

# 配置、快捷键、主题、日志和数据文件都在哪里
spf path-list

# 在 superfile 里，? 会打开完整的快捷键列表
spf --help

🎯 基本用法示例

启动它：

# 当前目录
spf

# 你指定的目录
spf /var/log

# 每个路径一个面板，并排打开
spf ~/src ~/Downloads /mnt/backup

# 试配置而不动你自己的文件
spf --config-file /tmp/spf.toml --hotkey-file /tmp/spf-keys.toml

# 装的是哪个版本？
spf --version

让配置保持最新：

# 补上新版本带来的配置项和快捷键，
# 你已经改过的内容一律不动
spf --fix-config-file
spf --fix-hotkeys

# 打印 superfile 用到的所有路径
spf path-list

# 提交问题报告时用的环境、终端和版本信息
spf --debug-info

接进你的 shell：

# 在 config.toml 里设置 cd_on_quit = true，再把下面这段
# 放进 ~/.bashrc 或 ~/.zshrc，这样用 Q 退出时，你就会停在
# 面板最后显示的那个目录里
spf() {
    export SPF_LAST_DIR="${XDG_STATE_HOME:-$HOME/.local/state}/superfile/lastdir"
    command spf "$@"
    [ ! -f "$SPF_LAST_DIR" ] || { . "$SPF_LAST_DIR"; rm -f -- "$SPF_LAST_DIR"; }
}

# 这个函数读取的路径
spf path-list --lastdir-file

# 把 superfile 当作别的程序的文件选择器：它会把选中的路径
# 写进这个文件然后退出
spf --chooser-file /tmp/picked

🚀 为什么选择 deb.griffo.io？

• ✅ 唯一的 apt 来源： Debian 与 Ubuntu 官方源都没有 superfile；本仓库打包官方上游发布版
• ✅ 命令是 spf： 软件包叫 superfile 是因为上游项目就叫这个名字，而它装进 PATH 的是 /usr/bin/spf，也就是所有教程和快捷键文档里用的那条命令
• ✅ 自动更新： 上游发布后数小时内更新软件包，所以 auto_check_update 可以关掉，检查交给 apt
• ✅ 完整的软件包： 官方上游的 Linux 构建，安装为 /usr/bin/spf，不加料、不打补丁
• ✅ 诚实的依赖： 二进制文件本身什么都不需要，xdg-utils 只是推荐，exiftool、zoxide、ffmpeg、poppler-utils 和剪贴板工具则作为建议，供用到它们的可选功能使用
• ✅ 两种架构： amd64 和 arm64，都是静态链接的 Go 二进制文件，同一个包在所有版本上都能运行
• ✅ 多发行版： 支持 Bookworm、Trixie、Forky 和 Sid
• ✅ 易于维护： 使用标准 apt 命令即可更新

📦 软件包构建仓库

Debian 软件包在这个 GitHub 仓库中自动构建和维护：

• 🗂️ superfile-debian - 最新版本构建

🔗 相关软件包

deb.griffo.io 同样提供：

• Yazi - 这里的另一个终端文件管理器，如果你更喜欢单面板和 Lua 插件
• zoxide - superfile 的 z 键背后的跳转数据库
• eza - 现代版 ls，用于那些不值得开文件管理器的列目录
• fzf 模糊查找器 - 从 shell 提示符开始的那类搜索