CTags

此Sublime Text软件包提供了使用由Exuberant CTags或Universal CTags生成的标签的支持。

ctags命令将在系统PATH中搜索。它通过在内存映射的标签文件上进行二分搜索来工作，因此在需要时可以有效地处理非常大的（50MB+）标签文件。

安装

Package Control

安装的最简单方法是使用Package Control。它列出的名称是CTags。

1. 使用菜单项目工具 → 命令面板...打开命令面板
2. 选择Package Control: Install Package
3. 找到CTags并按Enter

手动下载

1. 下载.zip
2. 解压缩并将文件夹重命名为CTags
3. 将文件夹复制到Packages目录，可以通过菜单项目首选项 → 浏览软件包...找到此目录

使用Git

前往你的Sublime Text软件包目录，并使用以下命令克隆仓库：

git clone https://github.com/SublimeText/CTags

其他设置步骤

Linux

要安装ctags，请使用你的包管理器。

• 对于基于Debian的系统（Ubuntu，Mint等）：

sudo apt-get install exuberant-ctags

或者

sudo apt-get install universal-ctags

• 对于基于Red Hat的系统（Red Hat，Fedora，CentOS）：

sudo yum install ctags

MacOS

OSX中的默认ctags可执行文件不支持递归目录搜索（即ctags -R）。为了得到ctags的正确副本，可以使用以下任意一个选项

• 使用Homebrew

brew install ctags

• 使用MacPorts

port install ctags

确保更新了PATH，以便运行正确的版本

• 如果which ctags没有指向/usr/local/bin中的ctags，请确保在报告的文件夹之前将/usr/local/bin添加到你的PATH中。
• 或者，将新 ctags 可执行文件的路径添加到设置中，在 command 下。如果您安装了 Xcode 或 Apple 开发者工具，此路径可能是 /usr/local/bin/ctags。

Windows

• 下载 Exuberant CTags 可执行文件 或 Universal CTags 可执行文件

• 将下载的 zip 文件中的 ctags.exe 解压到 C:\Program Files\Sublime Text 或您的 PATH 中的任何文件夹，以便 Sublime Text 可以运行它。

• 或者，将它们解压到任何文件夹，并将该文件夹的路径添加到 command 设置。

用法

此默认使用由 ctags -R -f .tags 命令创建的标签文件（尽管这可以在设置中覆盖）。

插件会尝试在当前视图所在的目录中寻找 .tags 文件，一直向上搜索直到找到。如果找不到，它会提供在当前视图的目录中建立一个新的选项。

如果无法在标签文件中找到符号，它将在 CTags.sublime-settings 文件中指定的其他位置进行搜索（见下文）。

如果您是 Ruby 开发者，可以使用以下脚本构建 Ruby Gem 的标签：

require 'bundler'
paths = Bundler.load.specs.map(&:full_gem_path)
system("ctags -R -f .gemtags #{paths.join(' ')}")

设置

要打开 CTags.sublime-settings

1. 使用菜单项目工具 → 命令面板...打开命令面板
2. 选择 偏好设置：CTags 设置 并按 Enter 键

• filters 允许您针对标签字段的特定范围设置筛选器。在上面的摘录中，会过滤导入的标签，如 from a import b

'(?P<symbol>[^\t]+)\t'
  '(?P<filename>[^\t]+)\t'
  '(?P<ex_command>.*?);"\t'
  '(?P<type>[^\t\r\n]+)'
  '(?:\t(?P<fields>.*))?'

• extra_tag_paths 是一个键列表，它包含额外的位置
• (selector, platform)。注意 platform 与 sublime.platform() 进行比较，所以任何返回的值都是有效的。
• extra_tag_files 是一个相对原始文件的额外文件列表
• command 是要使用的 ctags 版本的路径，例如：

"command" : "/usr/local/bin/ctags"

或者

"command" : "C:\\Users\\<username>\\Downloads\\CTags\\ctag.exe"

其他选项的解释相当直观。

从侧边栏隐藏 .tags 文件

默认情况下，Sublime 会将 ctags 文件包含到项目文件中，这会导致它们在文件树和搜索结果中显示。要禁用此行为，您应该在 Preferences.sublime-settings 或项目文件中添加一个 file_exclude_patterns 项目。例如：

"file_exclude_patterns": [".tags", ".tags_sorted_by_file", ".gemtags"]

支持

如有任何问题或建议，请 提出问题，我们将收到通知。

命令列表