📌 项目地址:yorukot/superfile | ⭐ 19,370 颗星 | 🔧 Go | 📜 未标注
superfile 是 GitHub 上 19,370 颗星的开源项目,用 Go 写的一个终端文件管理器。作者 yorukot 把它定位成现代化终端文件管理器,目标是在终端里做出不输给图形界面文件管理器的操作体验。
它长这样:
– 左侧是目录树
– 中间是文件列表
– 右侧是文件预览
– 底部是快捷操作栏
三个面板可以随时切换布局,文件预览支持图片、PDF、视频、压缩包、Office 文档等多种格式,这些在 README 的 demo 图里有展示。
安装方式覆盖了主流渠道
Linux 和 macOS 的安装命令是:
bash -c "$(curl -sLo- https://superfile.dev/install.sh)"
命令里的安装脚本放在仓库的 website/public/install.sh,执行前可以先拉下来看内容,不用盲信。
Windows 下有三条路:
# PowerShell 官方脚本
powershell -ExecutionPolicy Bypass -Command "Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.dev/install.ps1'))"
# winget
winget install --id yorukot.superfile
# scoop
scoop install superfile
想自己编译也行,步骤很直接:
git clone https://github.com/yorukot/superfile.git --depth=1
cd superfile
./build.sh # macOS/Linux
sudo mv ./bin/spf /usr/local/bin
# Windows 用
go build -o bin/spf.exe
启动命令很简单,就一个:
spf
操作逻辑:热键为主,多标签页是核心
superfile 把所有操作都绑定到了键盘上,常用操作基本不用碰鼠标。它支持多标签页,快捷键 Ctrl + T 新建标签页,Tab 切换。最核心的几个操作:
h/j/k/l或方向键移动光标Enter进入目录或打开文件Space选中文件y复制,x剪切,v粘贴Esc返回上级或取消操作?呼出帮助菜单
文件操作支持批量选中、压缩/解压、重命名、软链接创建,还带一个命令面板(Ctrl + F),可以直接输入命令操作。
交互方式和传统终端文件管理器(ranger、lf 这类)有区别。superfile 的侧重点是把界面做得接近图形界面工具的观感,圆角边框、单边框、图标支持,这些都是默认样式。
插件和主题系统
superfile 有插件机制,分为四种类型:
– 文件预览插件,比如 superfile-preview-image、superfile-preview-video、superfile-preview-pdf 这些二进制工具
– 文件处理插件
– 状态栏插件
– 命令行工具集
插件列表在 README 的 Plugins 章节有完整表格。主题则是通过修改配置文件实现的,配置文件在 ~/.config/superfile/,里面 hotkey.toml 定义快捷键,theme.toml 定义颜色方案。
配色方案用 hex 或者 ANSI 色值都行,改起来不复杂。官方的主题仓库也放了一些社区做好的主题可以直接抄。
一个值得注意的点:Windows 支持
README 里明确写了 Windows 是 “Not fully supported yet”。虽然提供了 Windows 的安装脚本和 winget/scoop 安装方式,但功能完整度不如 Linux/macOS。
如果你主力机是 Windows,建议先跑一下试用手感再决定要不要长期用。Linux 和 macOS 下没有这个问题。
项目现状和社区
项目的核心维护者是 Mikael Fangel,原作者 Yoruko 还在参与。贡献者列表挺长,完整的可以看 GitHub 上的 Contributors 页面。项目有个 Discord 频道,链接在 README 头部。
Star 数从 19,000 涨到 19,370,用了不到两周时间。这个增速背后是终端工具的活跃需求——终端文件管理器这个赛道,ranger 和 lf 统治了很久,确实需要新面孔。
我的一些实际使用感受
我在自己的环境中跑了一周,说几个实际体验。
启动速度很快,Go 编译的二进制文件,冷启动基本无感。和 vim/neovim 的联动流畅,把它当作快速浏览文件的工具用很顺手。
需要花时间的是配置。默认快捷键和 ranger 差异不小,如果你习惯 ranger 那套,需要改 hotkey.toml 适应一阵。主题配置文件是手写的 TOML,没有可视化编辑器,需要查文档才能摸清每个字段的作用。
文件预览功能值得单独说。superfile-preview-image 这类插件实际上把终端图像协议(如 Kitty Graphics Protocol)和终端特性做了封装,安装完插件后,图片和 PDF 在终端里真的能显示,视觉效果比传统终端文件管理器高出一截。
如果你像 ranger 或者 lf 的操作逻辑,刚开始可能不习惯。但 superfile 的定位和它们是有差异的——它在做图形界面文件管理器到终端的映射,熟悉之后操作效率会比 ranger 更高。
项目的自定义扩展文档在 https://superfile.dev/getting-started/tutorial/ 有完整的教程,插件开发者的接口文档也在那里。想自己开发插件的话,这个是入口。
最后给个建议:安装前值得先花五分钟看看 GitHub README 里的 demo 动图,确认它的交互风格是不是你想要的。终端文件管理器属于高频工具,换了之后要顺手才值得投入时间。