-
Notifications
You must be signed in to change notification settings - Fork 0
nvim workflow explorer
ES edited this page Jul 20, 2026
·
1 revision
vv-explorer 不是“左侧目录树插件”这么简单
它更接近一个编辑器内的文件管理器，负责：
- 浏览目录
- 即时预览文件
- 创建、删除、重命名
- 复制、剪切、粘贴
- 打开回收站并恢复文件
- 在树里直接开 split、执行文件、复制路径
如果只记一句话：
- Telescope 更像“找”
-
vv-explorer更像“管”
| 快捷键 | 作用 |
|---|---|
<leader>e |
Reveal 当前文件，并聚焦到树里的位置 |
<leader>E |
Toggle 文件树 |
:VVExplorerTrash |
打开回收站面板 |
经验上：
- 想看“当前文件在项目里的位置”，按
<leader>e - 想直接把文件树开出来常驻，按
<leader>E
适合：
- 在编辑器里持续看目录结构
- 一边移动光标一边预览文件
- 直接做文件管理操作
- 不离开当前 coding 上下文
适合：
- 你知道文件名或文本，想快速搜到
- 你不需要看树结构，只想跳过去
适合：
- 大量文件整理
- 终端态批量操作
- 离开 Neovim 做完整文件管理
所以这三者不是替代关系，而是分工关系：
- Telescope：查找入口
-
vv-explorer：编辑器内文件管理 - Yazi：终端级文件管理
| 键 | 作用 |
|---|---|
j / k
|
上下移动 |
<CR> / l
|
打开文件 / 展开目录 |
h |
收起目录或回到父目录 |
[ / ]
|
把根目录切到父目录 / 当前目录 |
. |
显示或隐藏 dotfiles |
I |
显示或隐藏 gitignored 文件 |
R |
强制刷新 |
q / <Esc>
|
清过滤、清选择，或关闭树 |
preview = true 默认开启，所以你用 j / k 在树里移动时，主编辑区会即时预览当前文件
也就是说：
-
j / k不只是“移动行” - 它还是“浏览文件内容”
这一点是 vv-explorer 最值钱的地方之一
这部分是它和普通文件树最大的区别
| 键 | 作用 |
|---|---|
a |
创建文件或目录，名字以 / 结尾时创建目录 |
d |
删除，默认进入回收站 |
r |
重命名 |
y |
标记复制 |
x |
标记剪切 |
p |
粘贴到当前目录 |
<Tab> |
多选 |
Y |
复制绝对路径 |
这是它非常像真正文件管理器的地方：
-
y不是复制文本，而是“标记文件用于复制” -
x是“标记文件用于剪切” -
p才是实际粘贴
再加上 <Tab> 多选，你可以直接在树里做批量文件搬运
这里的 r 不只是简单 mv
在支持 workspace/willRenameFiles / workspace/didRenameFiles 的 LSP 项目里，vv-explorer 会在文件重命名时自动通知 LSP，让 import 路径等相关引用一起更新，然后再执行磁盘重命名
也就是说：
-
r：重命名文件或目录，并尽量让 LSP 同步更新相关引用 -
grn：重命名代码符号本身，比如函数名、变量名、类型名
所以如果你的目标是“把 foo.ts 改成 bar.ts，同时让引用这个文件的 import 自动跟着改”，直接用 vv-explorer 的 r
| 键 | 作用 |
|---|---|
<C-x> |
横向 split 打开 |
<C-v> |
纵向 split 打开 |
o / gx
|
用系统默认程序打开 |
X |
按文件类型执行 |
t |
在当前节点目录打开终端 |
X 不是简单 chmod +x 后裸跑，它会按文件类型和 shebang 选择 runner
适合：
- 直接跑脚本
- 快速验证一个单文件工具
- 在当前文件所在目录下执行
当你在树里浏览某个目录时，按 t 可以直接在那个目录打开终端
这对下面两种场景很方便：
- 想在某个包目录里跑命令
- 想快速切到一个子目录做临时操作
这是 vv-explorer 明显强于普通文件树的地方
按 d 删除时，默认不是永久删除，而是进入 vv-explorer 自带的回收站
-
T：树内打开回收站面板 -
:VVExplorerTrash：命令打开
| 键 | 作用 |
|---|---|
r / <CR>
|
恢复到原路径 |
d |
永久删除这一项 |
D |
清空整个回收站 |
q / <Esc>
|
关闭 |
这意味着你在编辑器里删文件时，不必每次都冒永久删除的风险
按 / 进入过滤模式
过滤支持三种模式：
- fuzzy
- glob
- regex
在过滤提示里：
| 键 | 作用 |
|---|---|
<S-Tab> |
在 fuzzy / glob / regex 之间切换 |
<C-n> / <C-p>
|
跳到下一个 / 上一个匹配 |
<CR> |
确认并跳到第一个匹配 |
<Esc> / q
|
取消过滤 |
| 键 | 作用 |
|---|---|
] |
进入当前目录，把它变成新的 root |
[ |
回到父目录 |
这比单纯展开和收起目录更像真正的“项目根切换”
<leader>E- 用
j / k浏览并预览 - 用
<CR>真正打开需要编辑的文件
<leader>Ea / r / d / y / x / p- 需要批量时配合
<Tab>
T- 在回收站里找到目标
- 按
r或<CR>恢复
- 光标停在目标目录或其中一个文件上
- 按
t
vv-explorer 不是 LSP 面板，但它的文件重命名会主动和 LSP 协作
要分清两类“重命名”：
-
vv-explorer的r：重命名文件 / 目录，并在支持时让 LSP 同步更新 import 等文件级引用 - LSP 的
grn：重命名代码符号，比如函数、变量、类型、组件名
所以：
- 想改
foo.ts -> bar.ts，用vv-explorer的r - 想改
useTheme -> useAppTheme这种符号名，用grn