mirror of https://github.com/SpaceVim/SpaceVim.git synced 2025-01-24 02:20:03 +08:00

2017-08-28 21:23:16 +00:00

12 KiB

Raw Blame History

title
SpaceVim 中文手册

SpaceVim 中文手册

项目主页： https://spacevim.org

Github 地址 : https://github.com/SpaceVim/SpaceVim

SpaceVim 是一个社区驱动的模块化 vim/neovim 配置集合，其中包含了多种功能模块，并且针对 neovim 做了功能优化。spacevim 有多种功能模块可供用户选择，针对不同语言选择特定的模块，就可以配置出一个适合特定语言开发的环境。

使用过程中遇到问题或者有什么功能需求可以在 github 提交 issue，这将更容易被关注和修复。我们也欢迎喜欢 vim/neovim 的用户加入我们的 QQ 群，一起讨论 vim 相关的技巧，点击加入Vim/SpaceVim用户群。

以下是近几周的开发汇总：

安装
更新
文档
快速
- SpaceVim选项
- 延伸阅读
  - Vim 8 新特新之旅

安装

Linux 或 Mac 下 SpaceVim的安装非常简单，只需要执行以下命令即可：

curl -sLf https://spacevim.org/install.sh | bash

想要获取更多的自定义的安装方式，请参考：

curl -sLf https://spacevim.org/install.sh | bash -s -- -h

SpaceVim是一种模块化配置，可以运行在vim或者neovim上，关于vim以及neovim的安装，请参考以下链接：

安装neovim

从源码编译vim

windows系统下的安装步骤：

Windows 下 vim 用户只需要将本仓库克隆成用户 HOME 目录下的 vimfiles 即可，打开 CMD 默认的目录默认即为 HOME 目录，只需要执行如下命令即可：

git clone https://github.com/SpaceVim/SpaceVim.git vimfiles

Windows 下 neovim 用户需要将本仓库克隆成用户 HOME 目录下的 AppData\Local\nvim，想要获取跟多关于 neovim 安装相关的知识，可以访问 neovim 的 wiki， wiki 写的非常详细。打开 CMD 初始目录默认一般即为 HOME 目录，只需要执行如下命令即可：

git clone https://github.com/SpaceVim/SpaceVim.git AppData\Local\nvim

字体

SpaceVim 默认启用了Powerline 字体，默认的的字体文件是：DejaVu Sans Mono, Windows 用户直接下载下来右键安装即可。

vimproc.dll

Windows 下用户如果不方便编译，可以在qq群文件里面下载相应的dll文件放到vimproc 的lib目录，默认是 ~/.cache/vimfiles/repos/github.com/Shougo/vimproc.vim/lib/

更新

可以通过 :SPUpdate 命令来更新spacevim 以及包含的插件，如果需要更新指定的插件，如：startuptime.vim，只需要执行 :SPUpdate startuptime.vim，也可以通过 :SPUpdate SpaceVim 来更新 SpaceVim.

文档

优雅的界面

SpaceVim 集成了多种使用UI插件，如常用的文件树、语法树等插件，配色主题默认采用的是 gruvbox。

主题

SpaceVim 默认的颜色主题采用的是 gruvbox。这一主题有深色和浅色两种。关于这一主题一些详细的配置可以阅读 :h gruvbox.

如果需要修改 SpaceVim 的主题，可以在 ~/.SpaceVim.d/init.vim 中修改 g:g:spacevim_colorscheme。例如，使用 vim-one with dark colorscheme

let g:spacevim_colorscheme = 'one'
let g:spacevim_colorscheme_bg = 'dark'

快捷键	描述
`SPC T n`	切换至下一个随机主题
`SPC T s`	通过 Unite 选择主题

可以在主题模块中查看 SpaceVim 支持的所有主题。

注意:

SpaceVim 在终端下默认使用了真色，因此使用之前需要确认下你的终端是否支持真色，可以阅读 Colours in terminal 了解根多关于真色的信息。

字体

在 SpaceVim 中默认的字体是 DejaVu Sans Mono for Powerline. 如果你也喜欢这一字体，建议将这一字体安装到系统中。如果需要修改 SpaceVim 的字体，可以在用户配置文件中修改 g:spacevim_guifont，默认值为:

let g:spacevim_guifont = 'DejaVu\ Sans\ Mono\ for\ Powerline\ 11'

如果指定的字体不存在，将会使用系统默认的字体，此外，这一选项在终端下是无效的，终端下修改字体，需要修改终端自身配置。

快捷键导航

SpaceVim 所有的快捷键都不需要去记忆，有强大的快捷键导航系统来提示每一个按键的具体功能，比如 Normal 模式下按下空格键，将出现如下提示：

这一导航提示将所有以空格为前缀的快捷键分组展示，比如 b 是所以 buffer 相关的快捷键， p 是所有工程管理相关的快捷键。在导航模式下按下 <C-h> 你将在状态栏上看见相应的帮助信息，按键介绍如下：

按键	描述
`u`	撤销前一按键
`n`	导航系统下一页
`p`	导航系统前一页

模块化配置

SpaceVim 是由多个独立模块组成的配置集合，针对不同的功能需求，设计了多个模块，用户在使用的时候只需要载入相应的模块即可。比如对于 Java 开发者，载入 lang#java、autocomplete、checker、tags模块即可配置出一个适合 Java 开发的 Vim 环境。

SpaceVim 支持的模：http://spacevim.org/layers/

Denite/Unite为主的工作平台

Unite 的快捷键前缀是f，可以通过 g:spacevim_unite_leader 来设定，快捷键无需记忆，SpaceVim 有很好的快捷键辅助机制，如下是 Unite 的快捷键键图：

Denite 是新一代的插件，相比 Unite 速度更加快，安装也更加方便。的快捷键前缀是F，可以通过 g:spacevim_denite_leader 来设定。

自动补全

SpaceVim 采用最快补全引擎 deoplete, 该引擎不同与YouCompleteMe的主要一点是支持多源补全，而不单单是语义补全。而且补全来源拓展非常方便。

细致的tags管理

快速

SpaceVim 将从 ~/.SpaceVim.d/init.vim 和当前目录的 ./SpaceVim.d/init.vim 载入配置，并且更新 rtp，用户可以在 ~/.SpaceVim.d/ 和 .SpaceVim.d/ 这两个文件夹下编辑自己的脚本，和 SpaceVim 的配置文件。

示例：

" Here are some basic customizations,
" please refer to the ~/.SpaceVim.d/init.vim
" file for all possible options:
let g:spacevim_default_indent = 3
let g:spacevim_max_column     = 80

" Change the default directory where all miscellaneous persistent files go.
" By default it is ~/.cache/vimfiles/.
let g:spacevim_plugin_bundle_dir = '~/.cache/vimfiles/'

" set SpaceVim colorscheme
let g:spacevim_colorscheme = 'jellybeans'

" Set plugin manager, you want to use, default is dein.vim
let g:spacevim_plugin_manager = 'dein'  " neobundle or dein or vim-plug

" use space as `<Leader>`
let mapleader = "\<space>"

" Set windows shortcut leader [Window], default is `s`
let g:spacevim_windows_leader = 's'

" Set unite work flow shortcut leader [Unite], default is `f`
let g:spacevim_unite_leader = 'f'

" By default, language specific plugins are not loaded. This can be changed
" with the following, then the plugins for go development will be loaded.
call SpaceVim#layers#load('lang#go')

" loaded ui layer
call SpaceVim#layers#load('ui')

" If there is a particular plugin you don't like, you can define this
" variable to disable them entirely:
let g:spacevim_disabled_plugins=[
    \ ['junegunn/fzf.vim'],
    \ ]

" If you want to add some custom plugins, use these options:
let g:spacevim_custom_plugins = [
    \ ['plasticboy/vim-markdown', {'on_ft' : 'markdown'}],
    \ ['wsdjeg/GitHub.vim'],
    \ ]

" set the guifont
let g:spacevim_guifont = 'DejaVu\ Sans\ Mono\ for\ Powerline\ 11'

SpaceVim选项

选项名称	默认值	描述
`g:spacevim_default_indent`	2	对齐空格
`g:spacevim_enable_guicolors`	1	启用/禁用终端使用真色彩
`g:spacevim_windows_leader`	`s`	窗口管理快捷键前缀
`g:spacevim_unite_leader`	`f`	Unite快捷键前缀
`g:spacevim_plugin_bundle_dir`	`~/.cache/vimfiles`	默认插件缓存位置
`g:spacevim_realtime_leader_guide`	0	启用/禁用实时快捷键提示
`g:spacevim_guifont`	''	设置SpaceVim字体
`g:spacevim_sidebar_width`	30	设置边栏宽度，文件树以及语法树
`g:spacevim_custom_plugins`	`[]`	设置自定义插件

12 KiB Raw Blame History Unescape Escape