登录

superfile

yorukotMIT活跃维护

一款用 Go 写的现代终端文件管理器，界面漂亮、操作顺手，适合习惯在命令行里浏览和管理文件的人。

Pretty fancy and modern terminal file manager

v1.6.0发布于 2026-06-07 17:54 UTC24,049star +18 / 7 天833fork同步于 2026-11-10 17:23 UTC
终端文件管理器TUI命令行文件管理Go
对比 GitHub 官网bubbleteaclifile-managerfilemanagerfilesystem

怎么上手

由 README 提炼，执行前请确认
原文 
bash -c "$(curl -sLo- https://superfile.dev/install.sh)"
硬件要求按 README 说明

README 未说明；支持 Linux、macOS 和 Windows（Windows 尚未完全支持）

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

终端里的现代文件管理器，用键盘高效浏览和操作文件

一款用 Go 写的现代终端文件管理器，界面漂亮、操作顺手，适合习惯在命令行里浏览和管理文件的人。

核心能力

  • 在终端中完成常见文件操作
  • 支持自定义主题与插件扩展
  • 可自定义快捷键，并提供 vim 版本配置
  • 内置自动检查更新提示，可在配置中关闭

容易踩的坑

Windows 支持尚未完全完善；vim/nvim 用户需先把默认快捷键配置改为 vim 版本；自动更新检查默认开启，可在配置中设 auto_check_update 为 false 关闭

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本v1.6.0
全部 release
  1. v1.6.0最新正式版2026-06-07 · 2026-06-07 17:54 UTC

    This release focuses on preview reliability, richer file metadata, configurable sidebar behavior, and a refreshed website and logo design, alongside navigation improvements, better error messages, refactoring, dependency updates, and bug fixes.

    Install:

    Click me to know how to install

    Highlights

    • Improved image and file preview reliability through the Bubble Tea v2 migration. Thanks @lazysegtree for the implementation
    • New website & logo design. Thanks @elvisdragonmao for the implementation
    • Added richer file metadata, including binary architecture detection for ELF/PE/Mach-O, Linux attributes, and file type byte support in the permissions column. Thanks @barsaskn, @xelavopelk, and @booth-w for the implementation
    • Sidebar sections can now be configured for visibility and ordering. Thanks @Mjoyufull for the implementation
    • Improved file operation error messages for delete, paste, and file text preview failures. Thanks @xelavopelk for the implementation
    • Added split_file_panel key function and navigation improvements for file panels. Thanks @robert-zaremba, @xelavopelk, and @padda78 for the implementation

    New Contributors

    Detailed Change Summary

    Update
  2. v1.6.0-rc1pre-release2026-05-27 · 2026-05-27 11:24 UTC
    查看更新说明

    How to install the pre-release

    macOS/Linux

    SPF_INSTALL_VERSION=1.6.0-rc1 bash -c "$(curl -sLo- https://superfile.dev/install.sh)"

    Note: If you have spf installed via brew or another package manager, remove that installation first. Otherwise, running spf in the terminal might still point to the package manager version instead of the pre-release installed by the script.

    Windows

    $env:SPF_INSTALL_VERSION = "1.6.0-rc1"
Invoke-Expression ((New-Object System.Net.WebClient).DownloadString("https://superfile.dev/install.ps1"))

    Note: You can also build it from source. Refer to the README file in the repository for more information.

    After installation, ensure that spf --version prints:

    superfile version v1.6.0-rc1

    Major Changes

    • Improve image preview and file preview reliability through the Bubble Tea v2 migration #1406
    • New website & logo design #1423
    • Add richer file metadata, including binary architecture detection, Linux attributes, and file type byte in permissions column #1328, #1432, #1410
    • Add sidebar section visibility and ordering configuration #1323
    • Improve file operation error messages for delete, paste, and file text preview #1408, #1431, #1436

    All Changes

  3. v1.5.02026-01-13 · 2026-01-13 11:28 UTC
    查看更新说明

    This release brings major new features, including video and PDF preview support, multi-column file panels, and configurable navigation, alongside significant code refactoring and comprehensive bug fixes.

    Install:

    Click me to know how to install

    Highlights

    • Added video and PDF preview support via loading the first frame/page as an image. Thanks @Yassen-Higazi for the implementation
    • Multi-column file panel view with date/size/permission columns. Thanks @xelavopelk for the implementation
    • Configurable fast navigation in the Filepanel. See this PR for more details: https://github.com/yorukot/superfile/pull/1220
    • You can now configure spf to open files with specific extensions with your choice of editor application. Thanks @litvinov-git for the implementation See this PR for more details: https://github.com/yorukot/superfile/pull/1197
    • Terminal stdout support for shell commands
    • Allow launching with the filename. spf /a/b/c.txt will launch in /a/b with c.txt as the selected file.
    • Various bug fixes, including modal confirmations, layout issues, and race conditions. See 'Detailed Change Summary'

    Internal Updates

    • Separated FilePanel and FileModel into a dedicated package for better code organization
    • Comprehensive end-to-end testing with layout fixes
    • Enhanced dimension validation and sidebar fixes
    • Updated multiple dependencies including Astro, Go toolchain, and linters
    • Added gosec linter and MND linter with magic number cleanup

    Detailed Change Summary

    Update
    • allow hover to file #1177 by @lazysegtree
    • show count selected items in select mode #1187 by @xelavopelk
    • Add icon alias for kts to kt #1153 by @nicolaic
    • link icon and metadata #1171 by @xelavopelk
    • user configuration of editors by file extension #1197 by @litvinov-git
    • add video preview support #1178 by @Yassen-Higazi
    • Add pdf preview support #1198 by @Yassen-Higazi
    • Add icons in pinned directories #1215 by @lazysegtree
    • Enable fast configurable navigation #1220 by @lazysegtree
    • add Trash bin to default directories for Linux #1236 by @lazysegtree
    • add terminal stdout support for shell commands #1250 by @majiayu000
    • More columns in file panel (MVP) #1268 by @xelavopelk
    Bug Fix
    • only calculate checksum on files #1119 by @nikero41
    • Linter issue with PrintfAndExit #1133 by @xelavopelk
    • Remove repeated os.ReadDir calls #1155 by @lazysegtree
    • Disable COPYFILE in macOS #1194 by @lazysegtree
    • add miss
  4. v1.5.0-rc1pre-release2026-01-03 · 2026-01-03 05:22 UTC
    查看更新说明

    How to install the pre-release

    MacOS/Linux

    SPF_INSTALL_VERSION=1.5.0-rc1 bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"

    Note - If you have spf installed via brew or other package manager, you would need to remove that installation; otherwise, running spf command in the terminal might still point to the one you installed via the package manager, not the one you installed via the script.

    Windows

    powershell -ExecutionPolicy Bypass -Command "$env:SPF_INSTALL_VERSION=1.5.0-rc1; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"

    Note - You can also build it from source. Refer to the README file in the repository for more information. Ensure that spf --version prints superfile version v1.5.0-rc1

    Major Changes

    Major Changes

    • Configurable & faster navigation with a new key-driven navigation system. See this PR for more details: #1220
    • Terminal stdout support for shell commands, enabling direct output display.
    • Trash bin added to default directories on Linux.
    • Allow the preview panel to have borders.

    Internal Improvements

    • Major layout and dimension system overhaul, including sidebar, footer, file panel, preview border, and process bar behavior.
    • Introduction of layout and dimension validations and additional tests to prevent invalid UI states.
    • File model separation and rendering refactor, simplifying preview and file handling logic.
    • Some flaky unit tests fixed, improving CI reliability.

    All changes

    New Contributors

    • @majiayu000 made their first contrib
  5. v1.4.1-rcpre-release2025-12-21 · 2025-12-21 04:49 UTC
    查看更新说明

    How to install the pre-release

    MacOS/Linux

    SPF_INSTALL_VERSION=1.4.1-rc bash -c "$(curl -sLo- https://superfile.netlify.app/install.sh)"

    Note - If you have spf installed via brew or other package manager, you would need to remove that installation; otherwise, running spf command in the terminal might still point to the one you installed via the package manager, not the one you installed via the script.

    Windows

    powershell -ExecutionPolicy Bypass -Command "$env:SPF_INSTALL_VERSION=1.4.1-rc; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.netlify.app/install.ps1'))"

    Note - You can also build it from source. Refer to the README file in the repository for more information.

    Major Changes

    • Added video and PDF preview support.
    • Added hover-to-file behavior while launching Superfile. Launching spf /path/to/1.txt will open the directory containing 1.txt with 1.txt sepected
    • Enabled user-configurable editors per file extension.
    • Improve rendering performance by removing repeated syscalls.

    Internal improvements

    • Fixing some flaky tests
    • Refactoring and linter enablement

    Change details

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    License MIT Discord Link Release Homebrew downloads GitHub downloads CodeRabbit Pull Request Reviews

    Demo

    Perform common operations

    Content

    Installation

    macOS and Linux

    bash -c "$(curl -sLo- https://superfile.dev/install.sh)"

    If you want to inspect the script, see : install.sh

    Windows

    Powershell
    powershell -ExecutionPolicy Bypass -Command "Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.dev/install.ps1'))"

    If you want to inspect the script, see : install.ps1

    Winget
    winget install --id yorukot.superfile
    Scoop
    scoop install superfile

    More installation methods

    Click me to check on how to install

    Build

    You can build the source code yourself by using these steps:

    Requirements

    Build Steps

    Clone this repository using the following command:

    git clone https://github.com/yorukot/superfile.git --depth=1

    Enter the downloaded directory:

    cd superfile

    For macOS/Linux

    Run the build.sh file:

    ./build.sh

    Add the binary file to your $PATH, e.g., in /usr/local/bin:

    sudo mv ./bin/spf /usr/local/bin

    For Windows

    go build -o bin/spf.exe

    Edit System Environment Variables and add superfile repo's bin directory to your PATH

    Start superfile

    spf

    Supported Systems

    • [x] Linux
    • [x] macOS
    • [x] Windows (Not fully supported yet)

    Tutorial

    After you install superfile, you can go here to briefly understand how to use superfile!

    Plugins

    Click me to the plugins wiki

    Themes

    Click me to the theme wiki

    Hotkeys

    [!WARNING] If you are vim/nvim user please change your default hotkeys config to vim version!

    Click me to see the hotkey wiki

    Notes

    We have an auto update functionality, that fetches superfile's latest released version from github (if last timestamp of last version check was less than 24 hours) and prints a prompt to user, if there is a newer version available.

    You can turn this off, by setting auto_check_update to false in superfile config. Click me to see the config wiki

    Troubleshooting

    Click me to see common problem fix

    Uninstalling

    macOS and Linux

    bash -c "$(curl -sLo- https://superfile.dev/uninstall.sh)"

    If you want to inspect the script, see : uninstall.sh

    Besides the spf binary in /usr/local/bin or ~/.local/bin, the script also deletes your config and data folders: ~/.config/superfile, ~/.local/share/superfile and ~/.local/state/superfile (or the $XDG_*_HOME locations if you set them, on Linux or macOS), and ~/Library/Application Support/superfile on macOS.

    Windows

    To uninstall superfile on Windows, use this powershell script.

    powershell -ExecutionPolicy Bypass -Command "Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://superfile.dev/uninstall.ps1'))"

    This script does not remove your config and data folder. Delete %LOCALAPPDATA%\superfile manually if you want it gone.

    Other install methods

    If you installed superfile another way (for example with a package manager), run spf pl before uninstalling to see where your config and data folders are, then delete them yourself. See config file path for all locations.

    Contributing

    If you want to contribute please follow the contribution guide

    Click me to see changelog

    Thanks

    Support

    • a Star on my GitHub repository would be nice 🌟
    • You can buy a coffee for me 💖

    ko-fi

    Core maintainer

    We welcome anyone who wants to become a core maintainer. Feel free to reach out!

    Contributors

    Thanks to all the contributors for making this project even greater!

    Powered by

    Thanks to JetBrains team for providing open-source licenses to support the maintenance of superfile.

    Star History

    THANKS FOR All OF YOUR STARS! Your stars are my motivation to keep updating!

    ༼ つ ◕_◕ ༽つ Please share.

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    Files
    files-community·C#

    一款面向 Windows 的现代文件管理器，用多标签页、双栏浏览和 Fluent 设计改进资源管理器的使用体验，方便整理文件和文件夹。

    文件管理器+4文件管理
    46578+643.0kv4.32026-11-10 15:05 UTC
    yazi
    sxyazi·Rust

    用 Rust 写的终端文件管理器，基于异步 I/O 实现极快的目录浏览和文件操作，适合习惯命令行的开发者日常管理文件。

    终端文件管理器+4文件管理
    43334+631.1kv26.9.12026-11-10 07:28 UTC
    spacedrive
    spacedriveapp·Rust

    用 Rust 写的跨平台开源文件管理器，底层是虚拟分布式文件系统，能把多台设备上的文件统一管理，像访问本地一样浏览和整理。

    文件管理器+4文件管理
    39480+311.4k0.4.32026-11-06 11:49 UTC
    filebrowser
    filebrowser·Go

    File Browser provides a file managing interface within a specified directory and it can be used to upload, delete, preview and edit your files.

    文件管理
    358704.2k2026-07-31 10:06 UTC