NERDTree 是 Vim 中常用的文件树插件，可用于浏览目录、打开文件、创建标签页以及快速定位当前文件。

一、离线安装

1. 下载源码

访问 GitCode 镜像仓库：

https://gitcode.com/gh_mirrors/ne/nerdtree.git

下载 ZIP 压缩包后，将文件上传到内网并解压。

假设解压后的目录为：

~/nerdtree-master

2. 创建 Vim 插件目录

mkdir-p~/.vim/pack/vendor/start/nerdtree

3. 拷贝插件源码

cp-r/nerdtree-master/* /.vim/pack/vendor/start/nerdtree/

如果源码位于其他目录，只需要修改源路径，例如：

cp-r./NERDTree-master/* ~/.vim/pack/vendor/start/nerdtree/

或：

cp-r/home/user/download/NERDTree/* ~/.vim/pack/vendor/start/nerdtree/

4. 更新帮助文档

建议执行以下命令生成 NERDTree 帮助索引：

vim-uNONE-c"helptags ~/.vim/pack/vendor/start/nerdtree/doc"-cq

该命令不会打开 Vim 界面，执行完成后会直接返回终端。

二、Vim 配置

将以下内容添加到~/.vimrc中。

" 设置 Leader 键为逗号 let mapleader = "," " ============================================================ " NERDTree 配置 " ============================================================ " 窗口宽度为 31 列 let NERDTreeWinSize = 31 " 文件树显示在左侧 let NERDTreeWinPos = 'left' " 显示隐藏文件 let NERDTreeShowHidden = 1 " 显示行号 let NERDTreeShowLineNumbers = 1 " 使用简洁界面 let NERDTreeMinimalUI = 1 " 使用箭头显示目录 let NERDTreeDirArrows = 1 " 自动删除关闭后的缓冲区 let NERDTreeAutoDeleteBuffer = 1 " 打开文件后不自动关闭 NERDTree let NERDTreeQuitOnOpen = 0 " 显示书签 let NERDTreeShowBookmarks = 1 " NERDTree 状态栏名称 let NERDTreeStatusline = 'NERDTree' " ============================================================ " 忽略文件和目录 " ============================================================ let NERDTreeIgnore = [ \ '\.git$', '\.svn$', '\.hg$', \ '\.pyc$', '\.pyo$', '\.obj$', \ '\.class$', '\.jar$', '\.war$', \ '\.swp$', '\.swo$', '\.sobj$', \ '\.DS_Store$', '\.localized$', \ 'node_modules$', '\.pycache$', \ '\.cache$', 'out$', '\.repo$', \ 'build$', '\.idea$', '\.vscode$' \ ] " ============================================================ " 快捷键 " ============================================================ " 切换 NERDTree nnoremap <leader>n :NERDTreeToggle<CR> " 查找并定位当前文件 nnoremap <leader>f :NERDTreeFind<CR> " ============================================================ " 自动关闭 " 当只剩 NERDTree 窗口时，自动退出 Vim " ============================================================ autocmd BufEnter * if tabpagenr('$') == 1 && winnr('$') == 1 && exists('b:NERDTree') && b:NERDTree.isTabTree() | quit | endif

如果不设置 mapleader，Vim 默认使用反斜杠\作为 Leader 键。
上述配置将 Leader 键设置为逗号，因此快捷键为,n和,f。

三、配置说明

1. 界面配置

2. 文件过滤

配置会隐藏以下类型的文件和目录：

• Git、SVN、Mercurial 等版本控制目录：

  • .git
  • .svn
  • .hg

• 编译和临时文件：

  • .pyc
  • .pyo
  • .obj
  • .class
  • .jar
  • .war
  • .swp
  • .swo

• 常见项目和构建目录：

  • node_modules
  • .pycache
  • .cache
  • out
  • .repo
  • build
  • .idea
  • .vscode

• macOS 系统文件：

  • .DS_Store
  • .localized

3. 自动关闭行为

以下配置用于控制 NERDTree 的自动退出：

autocmd BufEnter * if tabpagenr('$') == 1 && winnr('$') == 1 && exists('b:NERDTree') && b:NERDTree.isTabTree() | quit | endif

当 Vim 中只剩下 NERDTree 窗口时，Vim 会自动退出。

四、常用操作

1. 启动或关闭 NERDTree

在 Vim 的普通模式下按：

,n

等价于执行：

:NERDTreeToggle

2. 查找当前文件

在 Vim 的普通模式下按：

,f

等价于执行：

:NERDTreeFind

该命令会打开 NERDTree，并定位到当前正在编辑的文件。

3. 直接使用命令

在 Vim 命令模式下执行：

• :NERDTree– 打开 NERDTree。
• :NERDTreeToggle– 切换 NERDTree 的显示状态。
• :NERDTreeFind– 查找并定位当前文件。

五、NERDTree 面板常用快捷键

进入 NERDTree 面板后，可以使用以下快捷键：

六、验证安装

重新打开 Vim 后，可以使用以下任一方式验证：

方法一：使用命令

:NERDTree

如果左侧出现文件树窗口，说明安装成功。

方法二：使用快捷键

按下：

,n

如果能够正常打开和关闭 NERDTree，说明配置生效。

方法三：查看帮助

在 Vim 中执行：

:help NERDTree

如果能够打开帮助文档，说明帮助索引生成成功。

七、常见问题

1. 快捷键,n或,f无效

确认~/.vimrc中包含：

let mapleader = ","

修改配置后，可以在 Vim 中执行：

:source ~/.vimrc

或者重新启动 Vim。

2. 找不到:NERDTree命令

检查插件目录结构是否正确：

~/.vim/pack/vendor/start/nerdtree/ ├── plugin/ ├── autoload/ ├── doc/ ├── lib/ └── nerdtree.vim

如果出现多层目录，例如：

~/.vim/pack/vendor/start/nerdtree/nerdtree-master/plugin/

说明拷贝层级不正确，需要将nerdtree-master内部的源码文件拷贝到：

~/.vim/pack/vendor/start/nerdtree/

3. 修改配置后没有生效

在 Vim 中执行：

:source ~/.vimrc

然后重新执行：

:NERDTreeToggle

或直接重启 Vim。