OmniComplete 并不是插件的名字,而是 Vim 众多补全方式中的一种(全能补全)。说白了 OmniComplete 其实就是根据光标前的内容猜测光标后的内容,具体怎么猜取决于所采用的脚本。
而 OmniCppComplete 就是专为 C/C++ 编写的 OmniComplete 一个补全脚本。
那么经常和 OmniCppComplete 一起出没的 Ctags 又是什么呢?Ctags 全名 Exuberant Ctags,是一个独立的程序(也就是说,其实和 Vim 一点关系都没有)。它可以为各种语言的源代码生成语言元素(language object)索引文件。对于 C/C++ 来说,就是把源代码中的各种宏、函数、类、类成员等等元素和它们的相关信息生成索引文件,供其它程序使用。
OmniCppComplete 脚本就是根据 Ctags 生成的索引文件进行补全的。 好了,背景知识就是这样,安装步骤如下:
D:/ctags
PATH
以生成 C++ 标准库索引文件为例:
D:/ctags/cpp_src
使用命令行进入 D:/ctags/cpp_src 后执行:
ctags -R --sort=1 --c++-kinds=+p --fields=+iaS --extra=+q --language-force=C++ -f cpp .
建议将上一步生成的 D:/ctags/cpp_src/cpp
文件放到一个专门放置索引文件的目录以便后面的统一设置,例如放到 D:/ctags/tags
其它库的索引文件也可以依法炮制,只需切换到该库的 include 文件夹,执行:
ctags -R --sort=yes --c++-kinds=+p --fields=+iaS --extra=+q --language-force=C++ -f <文件名> .
~/.vim
(unix) 或者 %HOMEPATH%\vimfiles
(Windows) 文件夹在 vimrc 文件中加入
" ctags 索引文件 (根据已经生成的索引文件添加即可, 这里我额外添加了 hge 和 curl 的索引文件)
set tags+=D:/ctags/tags/cpp
set tags+=D:/ctags/tags/hge
set tags+=D:/ctags/tags/curl
" OmniCppComplete
let OmniCpp_NamespaceSearch = 1
let OmniCpp_GlobalScopeSearch = 1
let OmniCpp_ShowAccess = 1
let OmniCpp_ShowPrototypeInAbbr = 1 " 显示函数参数列表
let OmniCpp_MayCompleteDot = 1 " 输入 . 后自动补全
let OmniCpp_MayCompleteArrow = 1 " 输入 -> 后自动补全
let OmniCpp_MayCompleteScope = 1 " 输入 :: 后自动补全
let OmniCpp_DefaultNamespaces = ["std", "_GLIBCXX_STD"]
" 自动关闭补全窗口
au CursorMovedI,InsertLeave * if pumvisible() == 0|silent! pclose|endif
set completeopt=menuone,menu,longest
另外,还需确认在 vimrc 中开启了 filetype
选项,不然 OmniComplete 无法自动识别 C/C++ 文件类型进行补全。
这样,在插入模式编辑 C/C++ 源文件时按下 .
或 ->
或 ::
,或者手动按下 Ctrl+X Ctrl+O 后就会弹出自动补全窗口,此时可以用 Ctrl+N 和 Ctrl+P 上下移动光标进行选择。
4. 在Vim中使用omnicppcomplete
在配置好Vim,并生成了ctags标签库前提条件下,Vim中在需要代码补全的地方使用快捷键<Ctrl-x><Ctrl-o>,omnicppcomplete会给出相应的提示信息,'↑'或'↓'可移动光标。
5. omnicppcomplete补全提示菜单使用<Ctrl-x><Ctrl-o>后,omnicppcomplete会弹出如下补全提示菜单
+-------------------------------------+ |method1( f + MyNamespace::MyClass| |_member1 m + MyNamespace::MyClass| |_member2 m # MyNamespace::MyClass| |_member3 m - MyNamespace::MyClass| +-------------------------------------+ ^ ^ ^ ^ (1) (2)(3) (4)其中1为符号名称;2为符号类型;3为访问控制标识;4为符号定义所在域(scope)。
5.1 符号名称1为omnicppcomplete所查找到的可选符号(symbol)名称,如以'('结尾,则为函数。
5.2 符号类型符号的类型,可能的值为
5.3 访问控制类成员访问控制,取值:
5.4 符号定义所在域符号在何处被定义。
6. omnicppcomplete选项设置Vim中,可以通过以下选项控制omnicppcomplete查找/补全方式:
也许你也已经注意到了一个问题,那就是「自动补全窗口的配色非常之丑」,Vim 自带的几个配色方案中只有两三种配色改掉了自动补全窗口丑陋的紫色,其它的基本上都是很逆天的用灰色表示当前选中项、紫色表示其他项。
要改变自动补全窗口的配色可以在 vimrc 中加上:
highlight Pmenu guibg=darkgrey guifg=black
highlight PmenuSel guibg=lightgrey guifg=black
Pmenu
是所有项的配色,PmenuSel
是选中项的配色,guibg
和 guifg
分别对应背景色和前景色。