OmniComplete是基于ctags的,所以要先安装ctags
到http://www.vim.org/scripts/script.php?script_id=2358下载cpp_src.tar.bz2,解压,进入目录,运行下面这条命令
ctags -R --sort=1 --c++-kinds=+p --fields=+iaS --extra=+q --language-force=C++ -f cpp
然后就会在这个目录下生成一个文件名为cpp的文件,这就是我们需要的
然后到http://www.vim.org/scripts/script.php?script_id=1520下载omnicppcomplete-0.41.zip
解压到/etc/vim目录下(解压出3个文件夹after, autoload, doc)
然后用编辑器打开/etc/vimrc,把下面内容粘进去(用文件名为cpp的文件的真实目录替换【目录】)
" ctags 索引文件 (根据已经生成的索引文件添加即可, 这里我额外添加了 hge 和 curl 的索引文件)
set tags+=【目录】/cpp
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
需要 " filetype plugin on ", 不然 OmniComplete 无法自动识别 C/C++ 文件类型进行补全。
要改变自动补全窗口的配色可以在 vimrc 中加上:
highlight Pmenu guibg=darkgrey guifg=black highlight PmenuSel guibg=lightgrey guifg=black
2. 使用ctags生成标签库
对于C++代码,ctags需要额外使用以下选项:
- --c++-kinds=+p : 为标签添加函数原型(prototype)信息
- --fields=+iaS : 为标签添加继承信息(inheritance),访问控制(access)信息,函数特征(function Signature,如参数表或原型等)
- --extra=+q : 为类成员标签添加类标识
3. omnicppcomplete补全提示菜单
使用后,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)。
3.1 符号名称
1为omnicppcomplete所查找到的可选符号(symbol)名称,如以'('结尾,则为函数。
3.2 符号类型
符号的类型,可能的值为
- c : 类(class)
- d : 宏(macro definition)
- e : 枚举值(enumeator)
- f : 函数(function)
- g : 枚举类型名称
- m : 类/结构/联合成员(member)
- n : 命名空间(namespace)
- p : 函数原型(function prototype)
- s : 结构体名称(structure name)
- t : 类型定义(typedef)
- u : 联合名(union name)
- v : 变量定义(variable defination)
3.3 访问控制
类成员访问控制,取值:
- + : 公共(public)
- # : 保护(protected)
- - : 私有(private)
3.4 符号定义所在域
符号在何处被定义。
5. omnicppcomplete选项设置
Vim中,可以通过以下选项控制omnicppcomplete查找/补全方式:
- OmniCpp_GlobalScopeSearch : 全局查找控制。0:禁止;1:允许(缺省)
- OmniCpp_NamespaceSearch : 命名空间查找控制。
- 0 : 禁止查找命名空间
- 1 : 查找当前文件缓冲区内的命名空间(缺省)
- 2 : 查找当前文件缓冲区和包含文件中的命名空间
- OmniCpp_DisplayMode : 类成员显示控制(是否显示全部公有(public)私有(private)保护(protected)成员)。
- 0 : 自动
- 1 : 显示所有成员
- OmniCpp_ShowScopeInAbbr : 选项用来控制匹配项所在域的显示位置。缺省情况下,omni显示的补全提示菜单中总是将匹配项所在域信息显示在缩略信息最后一列。
- 0 : 信息缩略中不显示匹配项所在域(缺省)
- 1 : 显示匹配项所在域,并移除缩略信息中最后一列
- OmniCpp_ShowPrototypeInAbbr : 是否是补全提示缩略信息中显示函数原型。
- 0 : 不显示(缺省)
- 1 : 显示原型
- OmniCpp_ShowAccess : 是否显示访问控制信息('+', '-', '#')。0/1, 缺省为1(显示)
- OmniCpp_DefaultNamespaces : 默认命名空间列表,项目间使用','隔开。
如:let OmniCpp_DefaultNamespaces = ["std', "MyNamespace"] - OmniCpp_MayCompleteDot : 在'.'号后是否自动运行omnicppcomplete给出提示信息。0/1, 缺省为1
- OmniCpp_MayCompleteArray : 在"->"后是否自动运行omnicppcomplete给出提示信息。0/1, 缺省为1
- OmniCpp_MayCompleteScope : 在域标识符"::"后是否自动运行omnicppcomplete给出提示信息。0/1, 缺省为0
- OmniCpp_SelectFirstItem : 是否自动选择第一个匹配项。仅当"completeopt"不为"longest"时有效。
- 0 : 不选择第一项(缺省)
- 1 : 选择第一项并插入到光标位置
- 2 : 选择第一项但不插入光标位置
- OmniCpp_LocalSearchDecl : 使用Vim标准查找函数/本地(local)查找函数。Vim内部用来在函数中查找变量定义的函数需要函数括号位于文本的第一列,而本地查找函数并不需要。