Neovim 文件资源管理器插件 nvim-tree.lua 完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01115/article/details/148443005

Neovim 文件资源管理器插件 nvim-tree.lua 完全指南

nvim-tree.lua 项目地址: https://gitcode.com/gh_mirrors/nvi/nvim-tree.lua

1. 项目概述

nvim-tree.lua 是一个为 Neovim 设计的现代化文件资源管理器插件，完全采用 Lua 编写。它提供了直观的文件浏览体验，集成了多种实用功能，是 Neovim 生态中广受欢迎的文件管理解决方案。

2. 核心特性

2.1 基本功能

自动更新：实时反映文件系统的变化
文件类型图标：直观展示不同类型的文件
高度可定制：从外观到行为均可按需配置

2.2 高级集成

Git 集成：显示文件在 Git 中的状态（已暂存、未跟踪等）
诊断集成：支持 LSP 和 COC 的诊断信息显示
实时过滤：快速定位目标文件

2.3 文件操作

基本操作：剪切、复制、粘贴、重命名、删除、创建
多窗口支持：支持在标签页、垂直/水平分割窗口中打开文件

3. 安装与配置

3.1 前置要求

Neovim 0.9.0 或更高版本
可选：nerd 字体（用于显示文件图标）

3.2 基础配置

-- 禁用内置的 netrw 文件浏览器
vim.g.loaded_netrw = 1
vim.g.loaded_netrwPlugin = 1

-- 启用 24 位真彩色（可选）
vim.opt.termguicolors = true

-- 基本设置
require("nvim-tree").setup()

3.3 进阶配置示例

require("nvim-tree").setup({
    sort = {
        sorter = "case_sensitive",  -- 文件名排序方式
    },
    view = {
        width = 30,  -- 窗口宽度
    },
    renderer = {
        group_empty = true,  -- 空目录分组
    },
    filters = {
        dotfiles = true,  -- 过滤点文件
    },
})

4. 使用指南

4.1 基本命令

| 命令 | 功能 | |------|------| | :NvimTreeOpen | 打开文件树 | | :NvimTreeClose | 关闭文件树 | | :NvimTreeToggle | 切换文件树状态 | | :NvimTreeFindFile | 定位并高亮当前文件 |

4.2 常用快捷键

| 快捷键 | 功能 | |--------|------| | <CR> | 打开文件/目录 | | a | 创建文件或目录 | | d | 删除文件 | | r | 重命名文件 | | x | 剪切文件 | | p | 粘贴文件 | | y | 复制文件名 |

4.3 高级操作

Git 操作：使用 [c 和 ]c 导航 Git 状态变化的文件
诊断导航：使用 [e 和 ]e 导航有诊断信息的文件
实时过滤：按 f 启动实时过滤，F 清除过滤

5. 自定义配置

5.1 快捷键自定义

local function my_on_attach(bufnr)
    local api = require "nvim-tree.api"
    
    -- 默认映射
    api.config.mappings.default_on_attach(bufnr)
    
    -- 自定义映射
    vim.keymap.set('n', '<C-t>', api.tree.change_root_to_parent, 
        { desc = "nvim-tree: 向上导航", buffer = bufnr })
end

require("nvim-tree").setup {
    on_attach = my_on_attach,
}

5.2 高亮自定义

vim.cmd([[
    hi NvimTreeExecFile    guifg=#ffa0a0
    hi NvimTreeSpecialFile guifg=#ff80ff gui=underline
    hi NvimTreeSymlink     guifg=Yellow  gui=italic
]])