vim配置之——ctags与TagList的配置以及NERDTree && doxygentoolkit的安装
参考(2)vim插件:显示树形目录插件NERDTree安装 和 使用
本文档主要对Linux下vim的ctags,TagList,NerdTree与doxgentoolkit进行相关的配置。
以下部分也是对于其他的摘抄:
一、软件ctags
(1)到 http://prdownloads.sourceforge.net/ctags/ctags-5.6.tar.gz
下载ctags源码ctags-5.6.tar.gz
(2)解压并安装
假设在家目录下taogle用户的目录下:
tar zxvf ctags-5.6.tar.gz
cd ctags-5.6
./configure && make && make install
(3)使用
<1> 对于一个工程文件夹如:cd /home/y/NXP_IMXSOLOX/linux-imx-imx_4.1.15_2.0.0_ga
<2> 建立ctags文件,在该目录下运行 ctags -R
—— "-R"表示递归创建,也就包括源代码根目录下的任何子目录下的源程式(如果你的源码是多层的目录, 就去最上层的目录)。从而在src目录下建立了一个“tags”文件,"tags"文档中包括这些对象的列表。
如果修改程序后,比如增加了函数定义,删除了变量定义,tags文件不能自动rebuild,必须再次在当前"tags"文件所在的目录下运行 $ctags -R
(4)跳转
1)用vim打开一个已经建过标签的c文件
2)ctrl+] 找到光标所在位置的标签定义的地方
3)ctrl+t 回到跳转之前的标签处
注意:此时运行vim,必须在"tags"文件所在的目录下运行。否则,运行它会找不到"tags"文件,而需要在vim中用":set tags="命令设定"tags"文件的路径。对于一个稍微大点的项目,你可能在任何一个目录下打开vim,然而在每个目录下都生成一个tags文件并不 是个好主意,那么如何解决呢?方法是在.vimrc中增加一行:
set tags=tags;/
这是告诉vim在当前目录找不到tags文件时请到上层目录查找。
注意:运行vim的时候,必须在"tags"文档所在的目录下运行。否则无法进行索引
二、需要额外安装的脚本:
1、taglist
下载Taglist,地址是http://sourceforge.net/projects/vim-taglist/files/vim-taglist/
解压taglist_45.zip,可以看到有两个目录doc和plugin,结构如下
taglist_45
|
|-------- doc
| \-------- taglist.txt
|
\-------- plugin
\-------- taglist.vim
执行下列shell命令,即安装完成
cp doc/taglist.txt /home/y/.vim
cp plugin/taglist.vim /home/y/.vim
用途:
打开后,可以显示源码的整体架构,方便地进行跳转。(用惯source insight的人一定勾起某些回忆了^_^)
在最后添加如下内容
"""""""""""""""""Taglist设置"""""""""""""""""
let Tlist_Auto_Open = 1
let Tlist_Ctags_Cmd = '/usr/bin/ctags'
let Tlist_Show_One_File = 1
let Tlist_Exit_OnlyWindow = 1
三:NERDTree的安装
(1)软件包获取:官网:http://download.csdn.net/detail/qq_27977257/9699985
(2)解压缩之后,把 plugin/NERD_tree.vim 和doc/NERD_tree.txt分别拷贝到~/.vim/plugin 和 ~/.vim/doc 目录。
注意:若在启动vim的时候出现:
Error detected while processing /home/.vim/plugin/NERD_tree.vim: line 68: E117: Unknown function: nerdtree#runningWindows E116: Invalid arguments for function <SNR>10_initVariable line 96: E117: Unknown function: nerdtree#runningWindows E15: Invalid expression: nerdtree#runningWindows() line 141: E117: Unknown function: nerdtree#loadClassFiles .................................
则可以将目录下的全部文件移动到$.vim目录下,这样就不会出现错误了,亲测。
在家目录下的.vimrc文件中我们需要添加:
----------------------------------------------------------------- " plugin - NERD_tree.vim 以树状方式浏览系统中的文件和目录 " :ERDtree 打开NERD_tree :NERDtreeClose 关闭NERD_tree " o 打开关闭文件或者目录 t 在标签页中打开 " T 在后台标签页中打开 ! 执行此文件 " p 到上层目录 P 到根目录 " K 到第一个节点 J 到最后一个节点 " u 打开上层目录 m 显示文件系统菜单(添加、删除、移动操作) " r 递归刷新当前目录 R 递归刷新当前根目录 "----------------------------------------------------------------- " F3 NERDTree 切换 map <F3> :NERDTreeToggle<CR> imap <F3> <ESC>:NERDTreeToggle<CR> let g:NERDTreeWinPos="left" let g:NERDTreeWinSize=25 let g:NERDTreeShowLineNumbers=1 let g:neocomplcache_enable_at_startup = 1 "----------------------------------------------------------------- " plugin - NERD_commenter.vim 注释代码用的, " [count],cc 光标以下count行逐行添加注释(7,cc) " [count],cu 光标以下count行逐行取消注释(7,cu) " [count],cm 光标以下count行尝试添加块注释(7,cm) " ,cA 在行尾插入 /* */,并且进入插入模式。 这个命令方便写注释。 " 注:count参数可选,无则默认为选中行或当前行 "----------------------------------------------------------------- let NERDSpaceDelims=1 " 让注释符与语句之间留一个空格 let NERDCompactSexyComs=1 " 多行注释时样子更好看
五:doxygentoolkit的用法
对于这个插件:可能对于某些人员而言是一个累赘,单对于在公司开发的人员而言确是一个不可缺少的插件,有关详细信息请百度,这里只介绍其安装的方法与使用的情况
插件获取:http://www.stack.nl/~dimitri/doxygen/download.html
安装步骤可以其网页上获取
git clone https://github.com/doxygen/doxygen.git
cd doxygen
mkdir build
cd build
cmake -G "Unix Makefiles" .. //可能有些需要进行sudo apt-get install cmake
make
make install
获取vimrc文件:http://download.csdn.net/detail/qq_27977257/9700042
cp DoxygenToolKlt.vim $.vim/pulg/
在vimrc中增加以下:
‘’----------------------------------------------------------------- " plugin - DoxygenToolkit.vim 由注释生成文档,并且能够快速生成函数标准注释 "----------------------------------------------------------------- let g:DoxygenToolkit_authorName="Mar_Wang, ext.wei.wang2@uaes.com" let g:DoxygenToolkit_briefTag_funcName="yes" let g:doxygen_enhanced_color=1 map <leader>da :DoxAuthor<CR> map <leader>df :Dox<CR> map <leader>db :DoxBlock<CR> map <leader>dc a /* */<LEFT><LEFT><LEFT> "-----------------------------------------------------------------
之后在vim中进行
License
将光标放在需要生成 License 的地方,然后输入命令 :DoxLic
Author
将光标放在合适的地方,然后输入命令 :DoxAuthor
Function / Class
将光标放在 function 或者 class 的名字所在的一行,然后输入命令 :Dox
Ignore code fragment (C/C++ Only)
如果想忽略调试部分的代码,那么只需要执行命令 :DoxUndoc(DEBUG) 即可
Group
输入命令 DoxBlock 来插入一个注释块
六:将我自己的vim配置贴上,希望对于有的朋友以帮助
set tags=tags "设置行号 set number "语法高亮 syntax on "自动对其 set tabstop=4 set softtabstop=4 set shiftwidth=4 set autoindent set cindent set smartindent set showmatch set tags=tags;/ “设置ctags set nocompatible " 关闭 vi 兼容模式 syntax on " 自动语法高亮 set number " 显示行号 set cursorline " 突出显示当前行 set ruler " 打开状态栏标尺 set shiftwidth=4 " 设定 << 和 >> 命令移动时的宽度为 4 set softtabstop=4 " 使得按退格键时可以一次删掉 4 个空格 set tabstop=4 " 设定 tab 长度为 4 set nobackup " 覆盖文件时不备份 set autochdir " 自动切换当前目录为当前文件所在的目录 filetype plugin indent on " 开启插件 set backupcopy=yes " 设置备份时的行为为覆盖 set ignorecase smartcase " 搜索时忽略大小写,但在有一个或以上大写字母时仍保持对大小写敏感 set nowrapscan " 禁止在搜索到文件两端时重新搜索 set incsearch " 输入搜索内容时就显示搜索结果 set hlsearch " 搜索时高亮显示被找到的文本 set noerrorbells " 关闭错误信息响铃 set novisualbell " 关闭使用可视响铃代替呼叫 set t_vb= " 置空错误铃声的终端代码 " set showmatch " 插入括号时,短暂地跳转到匹配的对应括号 " set matchtime=2 " 短暂跳转到匹配括号的时间 set magic " 设置魔术 set hidden " 允许在有未保存的修改时切换缓冲区,此时的修改由 vim 负责保存 set guioptions-=T " 隐藏工具栏 set guioptions-=m " 隐藏菜单栏 set smartindent " 开启新行时使用智能自动缩进 set backspace=indent,eol,start " 不设定在插入状态无法用退格键和 Delete 键删除回车符 set cmdheight=1 " 设定命令行的行数为 1 set laststatus=2 " 显示状态栏 (默认值为 1, 无法显示状态栏) set statusline=\ %<%F[%1*%M%*%n%R%H]%=\ %y\ %0(%{&fileformat}\ %{&encoding}\ %c:%l/%L%)\ " 设置在状态行显示的信息 "set foldenable " 开始折叠 "set foldmethod=syntax " 设置语法折叠 "set foldcolumn=0 " 设置折叠区域的宽度 "setlocal foldlevel=1 " 设置折叠层数为 " set foldclose=all " 设置为自动关闭折叠 " nnoremap <space> @=((foldclosed(line('.')) < 0) ? 'zc' : 'zo')<CR> " 用空格键来开关折叠 " return OS type, eg: windows, or linux, mac, et.st.. function! MySys() if has("win16") || has("win32") || has("win64") || has("win95") return "windows" elseif has("unix") return "linux" endif endfunction " 用户目录变量$VIMFILES if MySys() == "windows" let $VIMFILES = $VIM.'/vimfiles' elseif MySys() == "linux" let $VIMFILES = $HOME.'/.vim' endif " 设定doc文档目录 let helptags=$VIMFILES.'/doc' " 设置字体 以及中文支持 if has("win32") set guifont=Inconsolata:h12:cANSI endif " 配置多语言环境 if has("multi_byte") " UTF-8 编码 set encoding=utf-8 set termencoding=utf-8 set formatoptions+=mM set fencs=utf-8,gbk if v:lang =~? '^\(zh\)\|\(ja\)\|\(ko\)' set ambiwidth=double endif if has("win32") source $VIMRUNTIME/delmenu.vim source $VIMRUNTIME/menu.vim language messages zh_CN.utf-8 endif else echoerr "Sorry, this version of (g)vim was not compiled with +multi_byte" endif " Buffers操作快捷方式! nnoremap <C-RETURN> :bnext<CR> nnoremap <C-S-RETURN> :bprevious<CR> " Tab操作快捷方式! nnoremap <C-TAB> :tabnext<CR> nnoremap <C-S-TAB> :tabprev<CR> "关于tab的快捷键 " map tn :tabnext<cr> " map tp :tabprevious<cr> " map td :tabnew .<cr> " map te :tabedit " map tc :tabclose<cr> "窗口分割时,进行切换的按键热键需要连接两次,比如从下方窗口移动 "光标到上方窗口,需要<c-w><c-w>k,非常麻烦,现在重映射为<c-k>,切换的 "时候会变得非常方便. nnoremap <C-h> <C-w>h nnoremap <C-j> <C-w>j nnoremap <C-k> <C-w>k nnoremap <C-l> <C-w>l "一些不错的映射转换语法(如果在一个文件中混合了不同语言时有用) nnoremap <leader>1 :set filetype=xhtml<CR> nnoremap <leader>2 :set filetype=css<CR> nnoremap <leader>3 :set filetype=javascript<CR> nnoremap <leader>4 :set filetype=php<CR> " set fileformats=unix,dos,mac " nmap <leader>fd :se fileformat=dos<CR> " nmap <leader>fu :se fileformat=unix<CR> " use Ctrl+[l|n|p|cc] to list|next|previous|jump to count the result " map <C-x>l <ESC>:cl<CR> " map <C-x>n <ESC>:cn<CR> " map <C-x>p <ESC>:cp<CR> " map <C-x>c <ESC>:cc<CR> " 让 Tohtml 产生有 CSS 语法的 html " syntax/2html.vim,可以用:runtime! syntax/2html.vim let html_use_css=1 " Python 文件的一般设置,比如不要 tab 等 autocmd FileType python set tabstop=4 shiftwidth=4 expandtab autocmd FileType python map <F12> :!python %<CR> " 选中状态下 Ctrl+c 复制 vmap <C-c> "+y " 打开javascript折叠 let b:javascript_fold=1 " 打开javascript对dom、html和css的支持 let javascript_enable_domhtmlcss=1 " 设置字典 ~/.vim/dict/文件的路径 autocmd filetype javascript set dictionary=$VIMFILES/dict/javascript.dict autocmd filetype css set dictionary=$VIMFILES/dict/css.dict autocmd filetype php set dictionary=$VIMFILES/dict/php.dict "----------------------------------------------------------------- " plugin - bufexplorer.vim Buffers切换 " \be 全屏方式查看全部打开的文件列表 " \bv 左右方式查看 \bs 上下方式查看 "----------------------------------------------------------------- "----------------------------------------------------------------- " plugin - taglist.vim 查看函数列表,需要ctags程序 " F4 打开隐藏taglist窗口 "----------------------------------------------------------------- if MySys() == "windows" " 设定windows系统中ctags程序的位置 let Tlist_Ctags_Cmd = '"'.$VIMRUNTIME.'/ctags.exe"' elseif MySys() == "linux" " 设定windows系统中ctags程序的位置 let Tlist_Ctags_Cmd = '/usr/bin/ctags' endif nnoremap <silent><F4> :TlistToggle<CR> let Tlist_Show_One_File = 1 " 不同时显示多个文件的tag,只显示当前文件的 let Tlist_Exit_OnlyWindow = 1 " 如果taglist窗口是最后一个窗口,则退出vim let Tlist_Use_Right_Window = 1 " 在右侧窗口中显示taglist窗口 let Tlist_File_Fold_Auto_Close=1 " 自动折叠当前非编辑文件的方法列表 let Tlist_Auto_Open = 0 let Tlist_Auto_Update = 1 let Tlist_Hightlight_Tag_On_BufEnter = 1 let Tlist_Enable_Fold_Column = 0 let Tlist_Process_File_Always = 1 let Tlist_Display_Prototype = 0 let Tlist_Compact_Format = 1 "----------------------------------------------------------------- " plugin - mark.vim 给各种tags标记不同的颜色,便于观看调式的插件。 " \m mark or unmark the word under (or before) the cursor " \r manually input a regular expression. 用于搜索. " \n clear this mark (i.e. the mark under the cursor), or clear all highlighted marks . " \* 当前MarkWord的下一个 \# 当前MarkWord的上一个 " \/ 所有MarkWords的下一个 \? 所有MarkWords的上一个 "----------------------------------------------------------------- "----------------------------------------------------------------- " plugin - NERD_tree.vim 以树状方式浏览系统中的文件和目录 " :ERDtree 打开NERD_tree :NERDtreeClose 关闭NERD_tree " o 打开关闭文件或者目录 t 在标签页中打开 " T 在后台标签页中打开 ! 执行此文件 " p 到上层目录 P 到根目录 " K 到第一个节点 J 到最后一个节点 " u 打开上层目录 m 显示文件系统菜单(添加、删除、移动操作) " r 递归刷新当前目录 R 递归刷新当前根目录 "----------------------------------------------------------------- " F3 NERDTree 切换 map <F3> :NERDTreeToggle<CR> imap <F3> <ESC>:NERDTreeToggle<CR> let g:NERDTreeWinPos="left" let g:NERDTreeWinSize=25 let g:NERDTreeShowLineNumbers=1 let g:neocomplcache_enable_at_startup = 1 "----------------------------------------------------------------- " plugin - NERD_commenter.vim 注释代码用的, " [count],cc 光标以下count行逐行添加注释(7,cc) " [count],cu 光标以下count行逐行取消注释(7,cu) " [count],cm 光标以下count行尝试添加块注释(7,cm) " ,cA 在行尾插入 /* */,并且进入插入模式。 这个命令方便写注释。 " 注:count参数可选,无则默认为选中行或当前行 "----------------------------------------------------------------- let NERDSpaceDelims=1 " 让注释符与语句之间留一个空格 let NERDCompactSexyComs=1 " 多行注释时样子更好看 "----------------------------------------------------------------- " plugin - DoxygenToolkit.vim 由注释生成文档,并且能够快速生成函数标准注释 "----------------------------------------------------------------- let g:DoxygenToolkit_authorName="Mar_Wang, ext.wei.wang2@uaes.com" let g:DoxygenToolkit_briefTag_funcName="yes" let g:doxygen_enhanced_color=1 map <leader>da :DoxAuthor<CR> map <leader>df :Dox<CR> map <leader>db :DoxBlock<CR> map <leader>dc a /* */<LEFT><LEFT><LEFT> "----------------------------------------------------------------- " plugin – ZenCoding.vim 很酷的插件,HTML代码生成 " 插件最新版:http://github.com/mattn/zencoding-vim " 常用命令可看:http://nootn.com/blog/Tool/23/ "----------------------------------------------------------------- "----------------------------------------------------------------- " plugin – checksyntax.vim JavaScript常见语法错误检查 " 默认快捷方式为 F5 "----------------------------------------------------------------- let g:checksyntax_auto = 0 " 不自动检查 "----------------------------------------------------------------- " plugin - NeoComplCache.vim 自动补全插件 "----------------------------------------------------------------- let g:AutoComplPop_NotEnableAtStartup = 1 let g:NeoComplCache_EnableAtStartup = 1 let g:NeoComplCache_SmartCase = 1 let g:NeoComplCache_TagsAutoUpdate = 1 let g:NeoComplCache_EnableInfo = 1 let g:NeoComplCache_EnableCamelCaseCompletion = 1 let g:NeoComplCache_MinSyntaxLength = 3 let g:NeoComplCache_EnableSkipCompletion = 1 let g:NeoComplCache_SkipInputTime = '0.5' let g:NeoComplCache_SnippetsDir = $VIMFILES.'/snippets' " <TAB> completion. inoremap <expr><TAB> pumvisible() ? "\<C-n>" : "\<TAB>" " snippets expand key imap <silent> <C-e> <Plug>(neocomplcache_snippets_expand) smap <silent> <C-e> <Plug>(neocomplcache_snippets_expand) "-----------------------------------------------------------------