Space-vim documentation

layer, 名词有 "层次", 动词有 "分层" 的意思, 其实很简单, layer 这个概念不过是为了井然有序, 便于进一步的处理而已。就像计算机网络有应用层, 传输层等等, 每个 layer 有自己的职能。space-vim 中一个 layer 不过是针对某方面的 vim 配置与插件的集合.

在 space-vim 中, 像如下的 c-c++, graphviz, html 等等都为一个 layer. layer 的上一级目录, 比如 python layer 的上一级目录 +lang, 可称之为 topic. topic 下的内容均可认为是一个 layer.

layers
├── +lang
│   ├── c-c++
│   ├── graphviz
│   ├── html
│   ├── markdown
│   └── python
├── +themes
│   ├── airline
│   └── lightline
├── +tools
│   ├── fzf
│   └── ycmd
├── +version-control
│   ├── git
│   └── github
├── +vim
│   ├── better-defaults
│   ├── programming
│   └── text-align
└── LAYERS.md

一个 layer 通常由 3 个部分组成, README.md 为其简要介绍, config.vim 为针对该 layer 的配置信息, packages.vim 为支持该 layer 所需安装的一些插件.

python
├── README.md
├── config.vim
└── packages.vim

space-vim 的前缀键 (Leader key) 设置为空格键，取自 spacemacs. 当然了，在 spacemacs 之前就已经有很多人这么设置了, 它不是第一个，但是它的流行影响了很多人对 Leader key 的设置。

spacemacs 除了外观漂亮，社区驱动等等优点，主打 evil 并用空格键作为其前缀键可能也是其中一个成功的卖点，因为真的可以减轻手指负担，毕竟 "触手可及".

let g:mapleader="\<Space>"

从现代键盘设计的角度看，空格键理应受到优待, 毕竟一个人在 “VIP” 区占了好几个位. 即使 HHKB 这样的神器，也有空格键的一席之地.

关于 vim 自身的键位设定，刚开始时可能会觉得很奇怪, 为什么要用这几个键作为方向键呢? 这是因为以前的键盘长这样:

看到这个，也就应该能够理解为什么 vim 使用 hjkl 作为方向键，因为物理条件就是这样, 没得选. 参见 why-vim-uses-hjkl-as-arrow-keys .

又想马儿跑，又要马儿不吃草，那是不太现实的，所以要想要 space-vim 的体验好一些，一些准备工作必不可少.

启用 layer 非常简单，使用一键安装脚本安装 space-vim 时会自动在当前用户目录下生成一个 .spacevim ，可在其中的 Layers() 部分进行启用已有的 layer, 也可以在里面放置 space-vim 没有的插件：

每个 layer 下，通常附有一个 README 以简要说明，请在启用该 layer 时进行查阅 。

使用 Layer 命令可以加载 layer, 但是如果不想加载 layer 中的所有插件, 可以使用 exclude 选项进行部分禁用, 比如不想要 'itchyny/vim-cursorword' (这是给当前单词相匹配的所有单词加上下划线的插件):

function! Layers()

    Layer 'fzf'
    Layer 'unite'
    Layer 'better-defaults', { 'exclude': 'itchyny/vim-cursorword' }

endfunction

注意，如果是首次启用一个 layer，需要执行 SPC f R, 或者 :so $MYVIMRC, 重新加载 .vimrc 并执行 :PlugInstall 安装所需的相关插件 。或者退出重新打开 vim, vim-plug 将会检测并自动安装缺失的插件。

UserInit() 可以放置个人私有的一些插件。

function! UserInit()

   Plug 'extr0py/oni'

endfunction

.spacevim 中有个 UserConfig() ，可以将一些个性化配置放在这里, 对已有的一些配置信息进行覆盖。比如想换个主题, 自定义一些快捷键等：

function! UserConfig()

    color molokai
    nnoremap Q :qa!<CR>

endfunction

如果个性化配置比较多，也可以放在 private 目录下。private 可看做是一个 layer, 里面可以有 config.vim 与 packages.vim 这两个文件。如果这两个文件存在，space-vim 也会在启动时进行加载。

一些 “人性化” 设置和基本的键位映射，包括 buffer, window, esay-motion 快速移动等操作。了解 better-defaults 下面的键位设置非常重要，因为这些是所有快捷键设定的重要组成部分.

unite layer 主要希望提供一个界面来选择一些不太常用或稍复杂的命令.

insert mode 与 command mode 的快捷键大都由 rsi.vim 支持, :h rsi 查看其完整文档。 它是一种类似 Emacs 的键位绑定，这种设定在很多地方都是默认配置，比如 bash.

tabline 显示的信息示例: T-2:1/3W, T-当前 tab 编号:当前光标所在 Window 的编号/该 tab 所有的 window 总数.

当启用很多 layer 时, 意味着加载了很多插件与配置信息, 很可能会导致 vim 启动时变慢, 这是我们不愿意看到的.

从 vim-startuptime-benchmark 可以看出, 即使使用很多插件仍然可以保持很快的启动 ( 200 ms 以内). 尽管加载的插件不尽相同, 但仍具有借鉴意义. 这里 也有一篇关于 vim 启动优化非常好的文章。

虽然有些使用插件延迟加载, 但有一段时间 space-vim 启用很多 layer 时, 启动时间普遍超过 500 ms, 有时甚至会超过 900 ms. 测试环境:

• Retina 13-inch mid 2014

• VIM - Vi IMproved 8.0 (2016 Sep 12, compiled Nov 21 2016 17:35:16).

  vim --startuptime vim.log 会将启动时的一些时间, 加载的文件等情况写入到 vim.log 中, 大家可以自行测试一下.

虽然比起 spacemacs 几秒钟的启动时间, 几百毫秒已经很快. 但对于 vim, 启动迅速是硬性要求, 而且当超过 900 ms 时, 就会有明显的 lag. 后来在这里找到了暂时的解决方案: load-plugins-manually , 主要是 YouCompleteMe 与 ultisnips 两个插件.

下面是我一般会启用的 layer, 其中 airline 我已经默认不启用了, 因为可能会它可能会导致 100 ms 的启动延迟, 默认的 statusline 已经够用了, 我会在接下来介绍它。

function! Layers()

    Layer 'emoji'
    Layer 'goyo'

    Layer 'html'
    Layer 'c-c++'
    Layer 'python'
    Layer 'markdown'
    Layer 'graphviz'

    Layer 'airline'

    Layer 'chinese'

    Layer 'text-align'
    Layer 'programming'

    Layer 'ycmd'
    Layer 'syntax-checking'

endfunction

Terminal vim 默认的 statuline 显示的信息依次为:

buffer 编号 ❖ window 编号 [TOT: buffer 总数] 文件大小 文件名 fugitive/ale 信息  [文件类型] 文件编码 | 编码类型 | 行号:列号-虚拟列号 位置信息

GUI vim 由于渲染的原因，有些 unicode 字符无法正常显示, 因此去掉了 unicode 字符。

[buffer-编号] [window-编号] [TOT: buffer 总数] 文件大小 文件名 fugitive/ale 信息  [文件类型] 文件编码 | 编码类型 | 行号:列号-虚拟列号 位置信息

通过 statuline 的 window-编号, 可以使用 SPC 编号 切换到对应的 window. 通过 [TOT: buffer 总数], 可以知道当前共有几个 buffer, 使用 Tab 与 Shift-Tab 进行前后的 buffer 切换.

如果启用 airline Layer, 默认的 SPC [1-9] 快捷键可能不是那么人性化， 可以参考 这里 重新进行覆盖设置.