关闭

ctags使用

336人阅读 评论(0) 收藏 举报
分类:

ctags − Generate tag files for source code

ctags 最先是用来生成C代码的tags文件,后来扩展成可以生成各类语言的tags, 有些语言也有专有的tags生成工具(比如java的jtags,  python的 ptags).

 

ctags 生成的 tags文件可用于 vi 来做代码导航和 vi的onmicppcomplete 插件来做代码补全。  ctags -e生成的 TAGS文件可以用于 emacs.

 

技巧

最简单使用是 :    ctags –R  .

-R 表示递归子目录,   这个命令的意思就是为 当前目录下和其子目录下的文件建立索引( 索引只包含了函数的定义位置)

 

ctags 把 .cpp当成 c++来处理, .c当成c语言来处理, .h当成C++的头文件处理。

 

如果你程序中有的.c文件其实是C++程序,这该怎么办?  使用ctags --langmap=c++:+.c 

 

像C++标准库stl中文件名没有后缀,怎么办? 使用 ctags –force-language=c++ 这样就把所有文件当成C++来处理了。

 

如果一个目录下只有部分文件需要建立 tags, 怎么办呢?

使用 find 命令查找文件,bash 做后续处理,生成一个文件列表 比如叫  project.files,

最后使用 ctags –L project.files 命令

 

高级

为了字段补全有效, 需要加上其它的额外信息

这是很多推荐的C++  需要的选项:   --c++-kinds=+p  --fields=+iaS --extra=+q

选项 fileds 用于指定每条标记的扩展字段域

−−fields=[+|−]flags

a   Access (or export) of class members   类成员的访问属性

f   File-restricted scoping [enabled]

Inheritance information   继承信息

Kind of tag as a single letter [enabled]

Kind of tag as full name

l   Language of source file containing tag

Implementation information

Line number of tag definition

Scope of tag definition [enabled]

Signature of routine (e.g. prototype or parameter list)    函数原型

Include the "kind:" key in kind field

Type and name of a variable or typedef as "typeref:" field [enabled]

选项c++-kinds 用于指定C++语言的 tags记录类型,  --c-kinds用于指定c语言的,  通用格式是  --{language}-kinds

使用 ctags --list-kinds=c++ 可以查看选项:

c  classes
d  macro definitions
e  enumerators (values inside an enumeration)
f  function definitions
g  enumeration names
l  local variables [off]
m  class, struct, and union members
n  namespaces
p  function prototypes [off]
s  structure names
t  typedefs
u  union names
v  variable definitions
x  external and forward variable declarations [off]

我最后使用的—{language}—kinds 选项是 

--c-kinds=+cdefgmnpstuv

--c++-kinds=+cdefgmnpstuv

extra 选项用于增加额外的条目:   f表示为每个文件增加一个条目,  q为每个类增加一个条目

 

多目录

如果一个工程有多个完全不同的目录 保持文件,这该怎么办呢? 可

以为不同的目录生成不同的 tags文件, 最后在 vi中使用 let tags+=tags_file1 和let tags+=tags_file2 方式添加

 

vi 技巧

vi中如果在vimrc文件中初始话tags变量为  tags;   (有分号) , 那么 vi会先在当前目录中搜索  tags文件,如果没有查找到, 会到父级目录中查找tags文件,依次类推。

 

tags的局限性

tags文件之包含了 函数, 类或变量的定义的信息,而没有包含使用信息。 如果要知道一个函数都在什么地方使用过,需要使用 cscope工具

 

资料

程序站点:  http://ctags.sourceforge.net/ctags.html

ctags文件格式:http://ctags.sourceforge.net/FORMAT

Vimer中资料:http://www.vimer.cn/2009/10/%E5%9C%A8vim%E4%B8%AD%E4%BD%BF%E7%94%A8ctags.html

http://www.vimer.cn/2010/04/%E5%9C%A8vimgvim%E4%B8%AD%E4%BD%BF%E7%94%A8ctags2-%E5%A5%87%E6%8A%80%E6%B7%AB%E5%B7%A7.html

0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:43124次
    • 积分:809
    • 等级:
    • 排名:千里之外
    • 原创:29篇
    • 转载:62篇
    • 译文:0篇
    • 评论:0条