前言

很多程序員，包括我，會(huì)在寫(xiě)代碼的時(shí)候，習(xí)慣性的用TODO, FIXME, HACK等作為一些注釋的前綴。這樣方便自己和后來(lái)者預(yù)先知道相關(guān)注釋和代碼的狀況

不過(guò)這樣的備注只有是以后恰巧看到這段代碼的時(shí)候才能看到，沒(méi)法在一次發(fā)版或者空閑的時(shí)候，有一個(gè)直觀的界面能看到這個(gè)項(xiàng)目里面所有這樣的關(guān)鍵詞。

這個(gè)時(shí)候一個(gè)簡(jiǎn)單的自定義命令興許能幫到你：

command Todo Ack! 'TODO\|FIXME'

效果如下：

不過(guò)要想使這條命令生效，需要一些環(huán)境準(zhǔn)備工作

Ack

首先我們需要安裝Ack或者Ag，這兩個(gè)都是命令行下的一個(gè)全局搜索工具，比系統(tǒng)自帶的grep要快很多的。

這里的安裝以Ag為例，因?yàn)檫@個(gè)是基于C來(lái)重寫(xiě)的Ack并新增了很多特性，效率也是比Ack快了很多的。

# OSX
brew install the_silver_searcher
# Archlinux
pacman -S the_silver_searcher
# Ubuntu
apt-get install silversearcher-ag

在安裝完成之后，就可以在shell里面測(cè)試一下

ag TODO ./

Ack.vim

Ack.vim是一款插件，用來(lái)方便在Vim里面使用Ack/Ag, 然后通過(guò)Quickfix來(lái)提供搜索結(jié)果

不過(guò)這款插件，默認(rèn)是使用的Ack作為搜索引擎，為了能用上我們剛剛安裝的Ag，需要在~/.vimrc里面作一些配置：

if executable('ag')
 let g:ackprg = 'ag --vimgrep'
endif

這段配置是引用的官方倉(cāng)庫(kù)的Readme

不過(guò)也看很多人是用的

if executable('ag')
 let g:ackprg = 'ag --nogroup --nocolor --column'
endif

本人測(cè)試之后，發(fā)現(xiàn)二者并沒(méi)有什么區(qū)別?？赡軐?duì)于Ag來(lái)說(shuō) --vimgrep是等同于--nogroup --nocolor --column 的。

這個(gè)時(shí)候在Vim的命令行里面輸入

:Ack! TODO 

是可以實(shí)現(xiàn)上圖所示效果的，而且還可以通過(guò)

:AckAdd FIXME

這樣的方式來(lái)附加其它要查看的。

不過(guò)這樣的方式，命令還是有點(diǎn)長(zhǎng)。所以配置一個(gè)alias來(lái)替代上面的命令，是一個(gè)比較符合懶人的想法

在~/.vimrc里面新增

command Todo Ack! 'TODO\|FIXME'

然后在Vim的命令行里面輸入：

:Todo

就能實(shí)現(xiàn)列出當(dāng)前項(xiàng)目里面的所有TODO,FIXME了，而且可以根據(jù)自己的需要來(lái)擴(kuò)展這樣的關(guān)鍵字，像我就擴(kuò)展為如下代碼：

command Todo Ack! 'TODO|FIXME|CHANGED|BUG|HACK'
command Debug Ack! 'NOTE|INFO|IDEA'

區(qū)分了Todo和Debug兩種功能。

高亮

Vim里面會(huì)自動(dòng)的高亮TODO、FIXME，但是不會(huì)高亮CHANGED這樣的關(guān)鍵字，所以需要手動(dòng)的來(lái)指定一下，在~/.vimrc里面添加如下配置：

if has("autocmd")
 " Highlight TODO, FIXME, NOTE, etc.
 if v:version > 701
 autocmd Syntax * call matchadd('Todo', '\W\zs\(TODO\|FIXME\|CHANGED\|BUG\|HACK\)')
 autocmd Syntax * call matchadd('Debug', '\W\zs\(NOTE\|INFO\|IDEA\)')
 endif
endif

上面這段代碼是摘抄的，具體的功能就是匹配TODO等關(guān)鍵字，然后加上語(yǔ)法高亮。

綜上，一個(gè)簡(jiǎn)單好用的TODO管理器就已經(jīng)完成了。

總結(jié)

以上就是這篇文章的全部?jī)?nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作能帶來(lái)一定的幫助，如有疑問(wèn)大家可以留言交流，謝謝大家對(duì)腳本之家的支持。

最新評(píng)論