吴起的个人网站

vime

[](#1-about)1. About

vime

该项目的特点在于一个插件对应一个配置文件，只要在插件列表中增加了插件，那么就会自动载入该插件的配置文件。该项目耦合性很低，甚至每个插件配置文件单独拿出来放到你自己的vim配置中就可以直接使用了。

[](#2-整体结构)2. 整体结构

├── coc-settings.json
├── config/
   ├── custom/
   ├── plugins/
   ├── base.vim
   ├── keymap.vim
   ├── plug.vim
   ├── plugs-list.vim
   └── theme.vim
├── init.vim
└── vimrc -> ./init.vim
1
2
3
4
5
6
7
8
9
10
11

简单了解下整个结构，我用的插件管理器是junegunn/vim-plug。

目录结构：

  1. plug.vim文件就是vim-plug的插件配置文件，里面是我们需要的插件列表，写在这里面的插件在vim启动的时候会加载其对应的配置文件。插件的配置在config/plugins目录下，vim/nvim启动的时候会自行判断是否需要加载该目录下的插件配置。
  2. plugs-list.vim该文件是一些插件列表，不会加载，只是用来保存下都用过哪些插件，后期想更改插件的时候来这里先找。
  3. base.vim用于基础配置
  4. keymap.vim用于按键映射
  5. theme.vim用于主题配置
  6. plugins目录下是所有插件的配置文件，一个插件一个配置文件，只会加载plug.vim中安装的插件的配置。
  7. custom该目录是用户自己定义的简单脚本，该目录下的所有.vim脚本都会在启动的时候加载
  8. ~config.vim为了便于移植，取消了这种全局性的变量，一些需要配置文件路径的插件罗列如下，如果你需要某个插件的配置，直接复制这个插件的配置的话，需要将一些路径更改为自己的路径。~
    • ~config/plug.vim: g:plugins_path这是插件的安装目录~
    • ~config/plugins/fzf.vim.vim: g:fzf_dir这是fzf用到的目录，g:fzf_history_dir这是fzf的历史文件所在的目录~
    • ~config/plugins/coc.nvim.vim: g:coc_data_home 这是coc插件的安装目录~

[](#3-依赖)3. 依赖

注意，如果没有安装依赖，那么启动的时候会提示一些错误。如果不想安装一些不必要的依赖，那么只需要去除某些插件即可

需要安装如下软件：

  1. nodejs，npm，neovim(pip install)：必装
  2. ripgrep：必装，用于文件内容检索
  3. neovim-remote：可选，vimtex会用到，但是也可以不用，安装体验更好，pip install neovim-remote
  4. xdotool：可选，用于vimtex
  5. zathura：可选，用于vimtex的预览
  6. clangd：可选，用于c系补全，如果不需要，可以在config/plug.vim中去掉coc-clangd
  7. python-pysdl2 sdl2 sdl2-mixer: 可选，这是模拟机械键盘声音用到的，如果不需要可以在config/plug.vim中去掉keysound这个插件。

[](#5-安装)5. 安装

git clone https://github.com/fgheng/vime -C .config/nvim
1

然后打开neovim，执行:PlugInstall等待插件安装完毕即可！

[](#6-插件列表)6. 插件列表

这个直接查看config/plug.vim文件，里面是当前要加载的所有插件，当然你可以自己添加新的插件。

比如你要增加clever-f.vim这个插件。在config/plug.vim文件中加上Plug 'rhysd/clever-f.vim'，然后在config/plugins/目录下新建clever-f.vim.vim文件（注意命名，原插件为username/plugin_name，我们对应的配置文件需要命名为plugin_name.vim），接下来你就可以在新建的配置文件clever-f.vim.vim中进行相应的配置。

如果不想使用该插件了，那么直接在config/plug.vim文件中删除Plug 'rhysd/clever-f.vim'，而其对应的配置文件clever-f.vim.vim无需删除，下次打开vim/nvim的时候不会再加载对应的配置。如果某天你又像用该插件了，那么只需要添加Plug 'rhysd/clever-f.vim'，启动vim/nvim的时候会自动加载相应的配置，十分方便。

[](#7-快捷键)7. 快捷键

不管您选择了哪种补全插件，哪种检索插件，我们的快捷键配置都会尽可能保持一致，无须更改您的使用习惯，改变的只是neo/vim表现形式。

[](#71-补全行为)7.1 补全行为

补全使用的neoclide/coc.nvim插件，该项目中也有ycm-core/YouCompleteMe的配置，但最近主要使用coc，故ycm的配置已经很久不更新了。

按键 描述 提供者
tab 1. 如果存在下拉框，那么选择下一个
2. 如果不存在下拉框，那么强制显示下拉框，前提是有内容显示，否则输入tab coc
shift-tab 如果存在下拉框的话，选择下拉框的上一个 coc
enter 选中下拉框中的该条目，如果条目可以扩展，那么将会扩展 coc
gd 跳转到定义 coc
gr 跳转到引用 coc
gi 跳转到实现 coc
gy 跳转到类型定义 coc
alt-j 1. normal模式下，跳转到下一处错误

2. instert模式下，如果存在下拉框，选择下一个条目 3. instert模式下，如果存在snippet跳转块，跳转到下一处补全处 | coc | | alt-k | 同alt-j行为相反 | coc | | K | 查看当前光标下函数的帮助 | coc | | k | 查看当前光标下函数的参数帮助 | coc | | rn | 重命名变量、函数名称等 | coc | | f | 按照lsp的建议对代码错误进行自动修复 | coc |

按键 描述 提供者
l 打开coclist coc
a 打开coclist dialogistic coc
c 打开coclist command coc
o 打开coclist outline coc
O 打开coclist symbols coc

[](#72-窗口与tab)7.2 窗口与tab

按键 描述
==>窗口<==
ctrl-w-h/j/k/l 分别在当前窗口的左/下/上/右侧打开一个新的窗口
ctrl-h/j/k/l 分别移动光标到当前窗口的左/下/上/右侧窗口
alt-H/J/K/L 分别移动光标到当前窗口的左/下/上/右侧窗口
ctrl-w-o 最大化当前窗口，再按一次恢复
- 选择窗口
交换窗口
q 关闭窗口
alt+( 窗口左右方向变小
alt+) 窗口左右方向变大
alt+- 窗口上下方向变小
alt+_ 窗口上下方向变大
==>tab<==
tn 在后面新建一个tab
tc 关闭一个tab
alt-H/L 将当前的tab移动到左侧/右侧
alt-h/l 切换到上一个/下一个tab
如果存在浮动终端，则切换为上一个或下一个浮动终端

[](#73-文件管理)7.3 文件管理

文件管理使用的插件是weirongxu/coc-explorer、Shougo/defx.nvim，两者之一，需要在plug.vim中选择，快捷键行为基本一致。支持浮动窗口。

~同时可以使用f打开ranger。~ 因为coc-explorer开始支持浮动窗口，因此将f映射为了浮动模式的weirongxu/coc-explorer，不再使用ranger.vim，如果希望使用 ranger.vim，那么可以在plug.vim中加入ranger.vim即可。

按键 描述
j 下一个
k 上一个
h 收起目录
l 展开目录/打开文件
H 递归收起目录
L 递归打开目录
J 跳到下一个可以展开的地方
K 跳到上一个可以展开的地方
enter 进入目录并切换工作目录为进入的目录
back 跳到上一级目并切换工作目录为切换的目录
r 刷新目录
v 选中/取消选中，并向下移动
V 选中/取消选中，并向上移动
* 选中/取消选中
sh 水平打开
sv 垂直打开
st 新tab中打开
dd 剪切文件
Y 复制文件
D 删除文件
P 粘贴文件
R 重命名文件
N 添加文件或者目录，如果最后有/则表示添加目录
yy 复制文件路径
y 复制文件名称
. 显示/关闭隐藏文件

| x | 使用系统默认应用打开文件 | | f | 搜索文件 | | F | 递归搜索文件 |

[](#74-buffer与文件检索等)7.4 buffer与文件检索等

该操作主要由junegunn/fzf.vim、Yggdroot/LeaderF、neoclide/coc.nvim、liuchengxu/vim-clap中的一个完成，快捷键基本一致，主要看plug.vim中选择的是哪一个插件，其中 neoclide/coc.nvim优先级最低，有其他插件，那么就会覆盖掉coc的操作。

按键 描述 提供者
alt-r 最近打开的文件 fzf/leaderf/clap/coc
alt-b 显示当前打开的所有buffer fzf/leaderf/clap/coc
alt-f 1. 搜索工程目录下的文件
2. 搜索wiki笔记目录下的文件 fzf/leaderf/clap/coc
alt-F 搜索HOME下的所有文件 fzf/leaderf/clap/coc
alt-w 显示打开的窗口 fzf/leaderf/clap/coc
alt-m 显示所有的标记 fzf/clap/coc
alt-M 显示所有映射 fzf/clap/coc
alt-s 1. 使用rg搜索当前工程下的文件内容
2. 如果正在编辑wiki目录下的笔记，那么使用rg会搜索wiki笔记目录下的内容 fzf/leaderf/clap/coc
alt-c 显示所有命令 fzf/leaderf/clap/coc
？ 模糊搜索所有打开的buffer的内容 fzf/leaderf/clap/coc
alt-y 显示复制内容 clap/coc
alt-g 显示未提交的file列表 fzf/clap
alt-G 显示所有提交的file列表 fzf/clap/coc

[](#75-多光标)7.5 多光标

多光标使用的是插件vim-visual-multi以及coc自带的多光标，如果plug.vim中没有vim-visual-multi那么会使用coc自带的插件，coc行为与前者类似，但是功能不如前者多。

按键 模式 描述
tab visual-multi-mode 光标和扩展模式直接切换
shift-左右方向键 normal 选中区域并进入visual-multi-mode
ctrl-c normal 在当前位置插入一个光标（然后使用上下左右键移动到指定未知添加下一个光标，hjkl键会移动添加的光标）
ctrl-down/up normal 垂直方向插入多光标
ctrl-s normal/visual 1. 选中当前光标下的所有单词
2. visual模式下选中所有的当前选中的内容
ctrl-n/N normal 在visual模式下选中内容之后，按下ctrl-n会在下一处与当前选中内一样的地方插入光标。非visual模式下，与ctrl-s表现差不多，不过是依次选择当前光标下的单词。
q visual-multi-mode ~取消当前位置插入的光标，并跳到下一个匹配位置~
取消当前光标或者选中的区域
~Q~ ~visual-multi-mode~ ~取消当前的光标或者选中的区域~
]/[ visual-multi-mode 在多个选中的光标之间进行跳转
n/N visual-multi-mode 跳到下一个/上一个匹配的模式，可以代替]/[进行使用
S visual-multi-mode 在多光标模式下，将多个选中的内容以某种符号进行进行包围
o visual-multi-mode 交换光标位置
m
\/ normal 以正则匹配的方式设置多光标

[](#76-快速跳转)7.6 快速跳转

快速跳转使用的是vim-easymotion或者clever-f，easymotion中只使用了两个功能，一个是使用char进行跳转，另一个是跳转到行。

按键 模式 描述
f normal 根据输入的char进行跳转，按下f后会提示要跳转到哪个char，
需要再输入一个char然后回车确认
gl normal 跳转到行

[](#76-注释与文档)7.6 注释与文档

文档生成器使用kkoomen/vim-doge

按键 模式 描述
d normal 生成函数文档

注释插件使用nerdcomment或者tyru/caw.vim

caw快捷键，功能没有nerdcomment多，但是简洁够用

按键 模式 描述
cc nomal/visual 注释/取消注释
ci nomal/visual 在当前光标处加入注释
cI nomal/visual 在当前行的最开始加入注释
ca nomal/visual 在当前行最后加入注释
cw nomal 给单词加注释
cb nomal/visual 给选中的区域弄一个块注释
co nomal 在下一行加入注释
cO nomal 在上一行加入注释

下面的是nerdcomment的快捷键

按键 模式 描述
cc normal/visual 注释
cu normal/visual 取消注释选中的内容
cs normal/visual 用一种比较好看的方式注释当前行或选中的内容
ci normal/visual 注释/取消注释
cm normal/visual 用一种最简单的方式注释当前行或选中的内容
cl normal/visual 按行的方式注释选中的内容
cb normal/visual 注释选中的内容
ca normal 切换到另一种注释符号
cA normal 在当前行最后增加注释符号并进入插入模式
c$ normal 从当前光标处注释到当前行的最后
c

| cn | | |

[](#77-终端)7.7 终端

终端使用的是voldikss/vim-floaterm

按键 模式 描述
alt = normal 打开/关闭当前终端
alt + normal/tnormal 新建一个终端
alt h tnormal 打开终端后，切换到上一个终端
alt l tnormal 打开终端后，切换到下一个终端

[](#78-代码折叠)7.8 代码折叠

代码折叠使用的插件是pseewald/vim-anyfold

按键 模式 描述
zc normal 折叠
zC normal 循环折叠
zo normal 打开折叠
zO normal 循环打开折叠
zc normal 打开折叠或者关闭折叠
zA normal za的循环
zm normal 折起更多
zM normal 折起所有
zr normal 减少折叠
normal 打开所有折叠

[](#79-笔记)7.9 笔记

笔记使用的是插件vimwiki/vimwiki，可以记笔记可以写日记，支持markdown。

可以使用junegunn/fzf.vim、Yggdroot/LeaderF进行笔记文件和笔记内容的搜索，这个已经配置好了可以直接使用。

biji

按键 模式 描述
===>笔记<===
alt s normal 搜索vimwiki中的内容
ww normal 打开vimwiki
wt normal 在新的tab打开vimwiki
wd normal 删除当前page
wr normal 重命名当前的page
===>日记<===
wi 打开日记列表
wi 更新当前的日记列表
ww 打开今天的日记
wt 在新的tab中打开今天的日记
ctrl up/down 打开昨天/明天的日记
===>导航<===
enter 创建链接
ctrl shift enter
back 回到上一级目录
tab 跳转到下一处链接
shift tab 跳转到上一处链接
===>编辑快捷键<===
= 增加标题
- 减少标题
+ 创建链接
glm 增加list item的缩进
gll 减少list item的缩进
gl* 或 gl8 将该行变为*条目
gl# 或 gl3 将该行变为#
gl- 将该行变为-
gl1 将改行变为1.
===>表格模式<===
cr insert 插入模式
tab instert 插入模式，跳到下一个输入框
gqq 或 gww normal 格式化表格

[](#710-书签)7.10 书签

标记使用vim-bookmarks或者coc-bookmark，因为coc-explorer支持显示coc-bookmark中的书签，所以我使用 coc-bookmark，不过可以在config/plug.vim中加入vim-bookmarks两者快捷键一致

按键 模式 描述
ma normal 增加一个带有备注的书签
mm normal 增加一个标签
ml nromal 打开书签列表
mc nromal 清除标签
mj/k normal 跳转标签

[](#711-session)7.11 session

默认使用了vim-startify这个插件作为开始界面，该插件的可以自定义起始界面，配置在./config/plugins/vim-startify.vim下，可以自定义配置。session使用轮换方式，第一次存储一个session0，第二次还是存储session0，不过上一次的session0变为了session1，第三次存储session0，前面的session0变为session1，session1变为session2。

[](#712-surround)7.12 Surround

Surround是使用快捷键来给指定的字符串添加包围，比如引号等。使用的插件是tpope/vim-surround

按键 模式 描述
cs"'' normal changed surround "' 将双引号改为单引号
cs' normal 将单引号改变为包围
cst" normal 将tag改变为双引号，比如hello变为"hello"
ds" normal 删除双引号
ysiw] normal iw是选择一个单词，在选中的单词处增加中括号
ysiw[ normal 同上，不过两侧会增加空格
yss) normal 整行增加括号
ysiw normal 在一个单词处增加包围

[](#713-git)7.13 Git

git插件可以选择使用airblade/vim-gitgutter、tpope/vim-fugitive、neoclide/coc-git

按键 模式 描述 提供者
~gf~ normal 折叠/打开未改变的行 gitgutter
~gk~ normal 跳转到上一个修改地方 coc-git
~gj~ normal 跳转到下一个修改地方 coc-git
~gp~ normal 浮动预览光标处的修改 coc-git
~gu~ normal 撤销光标处相对于上次提交的修改 coc-git
gb normal 打开/关闭 blame fugitive
gs normal git different split fugitive
~gm~ normal 查看当前文件的commits fzf/coc-git
~gM~ normal 查看所有的commits fzf/coc-git
gc normal git commit fugitive
gw normal 写入，相当于git add fugitive

[](#714-数据库)7.14 数据库

数据库可以选择使用tpope/vim-dadbod

[](#715绘图)7.15绘图

绘图使用vim-scripts/DrawIt，命令行输入DrawIt进入绘图模式。

[](#716-latex)7.16 Latex

latex可以选择使用lervag/vimtex

vimtex的快捷键都是以l作为开头的。

按键 模式 描述
ll normal 准备编译文档
lv normal 在pdf文档中定位到当前位置
ll or lk normal 停止编译
le normal 删除log，errors以及warnings
lc normal 删除多余的文档
% normal 在定界符之间跳转

关于neovim+vimtex+zathura的反向搜索，也就是在从zathura定位到vim中的代码位置，首先需要安装一些依赖，neovim-remote、xdotool，然后需要编辑zathura的配置文件~/.config/zathura/zathurarc，加入如下内容：

set synctex true
set synctex-editor-command "gvim --remote-silent +%l %f"
1
2
3

这样在zathura中就可以使用ctrl+鼠标左键直接定位到对应的代码位置了。

[](#717-debug)7.17 Debug

debug可以选择使用puremourning/vimspector，暂时没有需求，所以还没有配置。

[](#718-run)7.18 Run

代码run使用韦大的插件，但是我现在还没有需求，做一暂时没有配置。

[](#719-翻译)7.19 翻译

翻译之前使用voldikss/coc-translator，接下来又换成了voldikss/vim-translator然后感觉都稍微有些许问题，最后选择了iamcco/dict.vim，但是该插件不支持悬浮窗口，我需要对其更改下支持悬浮窗口。

按键 模式 描述
w normal/visual 翻译当前光标下的内容/选中的内容，在新窗口展示
e normal/visual 在命令栏输出解释
r normal/visual 用翻译内容替换当前光标或选中的内容

[](#720-其他)7.20 其他

按键 模式 描述
alt q normal 进入宏录制，因为q映射为了关闭窗口，所以使用alt q作为宏录制
ctrl x normal 使用系统默认应用打开当前buffer文件
normal 保存所有的buffer，不包括terminal，目录树等

fgheng/vime: vime，my neovim config

← vim前端配置 →