fyler.nvim

FylerOrgApache-2.0活跃维护

把文件系统当缓冲区来编辑的 Neovim 文件管理器,树形视图里直接增删改文件和目录,省去在终端和编辑器间来回切换。

A neovim file manager which can edit file system like a buffer with tree view

v2.0.0发布于 2025-11-23 09:59 UTC768star56fork同步于 2026-11-07 07:33 UTC

怎么上手

由 README 提炼,执行前请确认
{ 'FylerOrg/fyler.nvim', opts = {} }
硬件要求按 README 说明

README 未说明,仅要求 Neovim >= 0.11

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

Neovim 文件管理器,像编辑缓冲区一样改文件系统,同时保留树形视图

把文件系统当缓冲区来编辑的 Neovim 文件管理器,树形视图里直接增删改文件和目录,省去在终端和编辑器间来回切换。

核心能力

  • 把文件系统当缓冲区编辑,直接增删改文件
  • 提供树形结构展示目录与文件
  • 支持 :Fyler 命令与 Lua API 两种打开方式
  • 可指定 root_path 切换起始目录
  • 可指定 kind 以左侧分屏等布局打开

容易踩的坑

需要 Neovim 0.11 及以上版本,低版本无法使用;README 未给出默认键位,需自行用 vim.keymap.set 绑定 fyler.open

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

最近发版

5 个版本v2.0.0
  1. v2.0.0最新正式版2025-11-23 · 2025-11-23 09:59 UTC

    Banner

    Breaking Changes

    • API track_buffer renamed to navigate.
    • Configuration structure changed.

    Performance updates

    • Plugin now supports asynchronous operations
    • Faster operation resolution
    • File focusing is instant even in heavily nested code base.
    • File tree will render instantly even when git status are enabled.

    Thanks to the contributors!

    • @jemag
    • @Allaman
    • @b0o
    • @jellli
    • @samiulsami

    Checkout new configuration options here

  2. v2.0.0-alphapre-release2025-11-10 · 2025-11-10 13:12 UTC
    查看更新说明

    Breaking changes

    • Configuration structure changed(again, sorry but it is for great).

    Performance improvements

    • Now using Trie data structure instead of N-ary tree data structure for faster update.
    • Due to Trie integration operations resolution is much faster and error free.
    • Focusing a buffer is much faster due to Trie lookup traversal.
    • Git statuses are now going to update lazily.

    More detailed information will be available on latest release

    Thanks to contributors who make this possible.

    • @jellli
    • @Allaman
    • @samiulsami
  3. v1.1.02025-10-01 · 2025-10-01 07:26 UTC
    查看更新说明

    Features

    • Added toggle API with custom options support
    • Added API to get node_entry under cursor
    • Added explorer reference to action mappings

    Fixes

    • Fixed Windows hangs on file creation
    • Fixed focusing current buffer when opening tree on Windows
    • Fixed missing annotation for mappings options

    Contributors

    • @cpea2506
    • @DrKJeff16
    • @Rexcrazy804
    • @sand4rt
  4. v1.0.02025-09-28 · 2025-09-28 07:04 UTC
    查看更新说明

    Breaking changes

    • New configuration structure
    • New git status render format
    • Fyler no longer track or focus buffer outside the working directory
    • Fyler open API options are changed

    What's new?

    • Fyler new replace window kind like oil.nvim
    • Telescope extension with zoxide to quickly open recently visited directories with fyler
    • Better git status render format and customization symbols
    • Hooks to for custom functionality over various operations
    • Directory icons can now be customized according to their state
    • Fyler window kinds can be configure separately using presets
    • Addition of various new action
    • Builtin mappings can be disabled
    • Custom mappings can be added with both action string and simple lua function
    • Can change plugin highlights with on_highlights with respect to theme
    • Copy operation is added
    • Can disable auto buffer tracking

    New Contributors

    • @sand4rt
    • @AgrimV
    • @JustinStitt
    • @WayenVan
    • @rachartier
    • @manuuurino
    • @uimataso
    • @RizaHKhan
    • @ellisra
    • @Doppie23
    • @phanen
    • @mintoya
  5. v0.1.02025-07-21 · 2025-07-21 10:03 UTC
    查看更新说明

    Today we are finally releasing fyler v0.1.0, our first stable release.

    [!IMPORTANT] From now on we are splitting to a new branch stable. Please visit README.md

    stable branch will not get update constantly in comparison with main because this branch contains only most stable and tested state of code.

    Future outlook

    We are thinking to implement a diffing algorithm to improve rendering engine

    Special thanks to contributors

    To both contributors who joined us to help speed up the development process.

    • @ChristofferNissen
    • @Jeansidharta

用户点评

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

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

    README 原文

    未翻译

    INTRODUCTION

    Fyler.nvim is oil.nvim inspired file manager plugin for neovim which can manipulate file system like a neovim buffer and provide a proper file-tree representation of items.

    REQUIREMENTS

    • Neovim >= 0.11

    INSTALLATION

    lazy.nvim

    { 'FylerOrg/fyler.nvim', opts = {} }
    

    mini.deps

    require('mini.deps').add('FylerOrg/fyler.nvim')
    

    vim.pack

    vim.pack.add({ 'https://github.com/FylerOrg/fyler.nvim' })
    

    USAGE

    Open Fyler using the :Fyler command:

    :Fyler                    " Open the finder
    :Fyler root_path=<path>   " Use a different directory path
    :Fyler kind=<buffer_kind> " Open specified kind directly
    

    Open Fyler from Lua:

    local fyler = require('fyler')
    
    -- open using defaults
    fyler.open()
    
    -- open as a left most split
    fyler.open({ kind = "split_left_most" })
    
    -- open with different directory
    fyler.open({ root_path = "~" })
    
    -- You can map this to a key
    vim.keymap.set("n", "<leader>e", fyler.open, { desc = "Fyler.nvim - Open" })
    
    -- Wrap in a function to pass additional arguments
    vim.keymap.set(
        "n",
        "<leader>e",
        function() fyler.open({ kind = "split_left_most" }) end,
        { desc = "Fyler.nvim - Open" }
    )
    

    LICENSE

    Apache 2.0. See LICENSE.

    [!NOTE] Run :help fyler.nvim OR visit wiki pages for more detailed explanation and live showcase.

    CREDITS