索引
版本信息

Sublime Text 包含一个索引引擎,它会扫描窗口/项目中的所有文件和文件夹,并使用该信息提供跳转到定义和提供上下文感知的自动完成功能4050

功能🔗

转到定义🔗

在扫描项目中的文件时,索引引擎会记录每个符号及其位置的列表。每种语法都可以定义什么被归类为符号,但通常会对函数、方法、类和其他数据类型进行索引。除了记录定义的位置之外,索引器还会记录引用 - 对已知符号的调用或调用。

可以通过以下方式访问符号索引

  • 将鼠标悬停在单词上以显示“转到定义”弹出窗口

  • 调用“在项目中转到符号”以模糊搜索符号
    • Windows/Linux: Ctrl+Shift+R

    • Mac: +Shift+R

  • 执行“转到定义”以查找插入符号下的单词 F12

  • 执行“转到引用”以查找插入符号下的单词 Shift+F12

所有“转到”命令也可以通过 转到 菜单调用。

上下文感知的自动完成🔗

除了提供有关符号的信息外,索引还用于提供上下文感知的自动完成。索引器会列出项目中存在的所有单词,以及有关单词序列和任何尾随标点符号的信息。

显示自动完成时,会查询索引以提供智能建议。如果没有索引,Sublime Text 将只建议当前文件中匹配的单词。使用索引时,它会提供所有文件的自动完成,使用前面的单词来帮助建议更好的匹配,并在适当时建议尾随标点符号。

4050

状态🔗

可以通过 帮助 ▶ 索引状态… 菜单项查看索引引擎的当前状态和活动。这将显示一个窗口,其中包含当前状态、进度条和索引消息日志。

索引引擎处于活动状态时,状态栏将包含一个带有百分比的文本标签。此百分比表示索引处于活动状态,以及进程的进度。单击百分比将打开“索引状态”窗口。

设置🔗

索引引擎使用低优先级的后台进程来加载和分析项目中的文件。根据机器和可用资源,可能需要修改配置以确保进程不会干扰机器的其他使用。

"index_files" 布尔值🔗

如果索引引擎已启用

默认值: true

"index_workers" 整数🔗

要使用的后台进程数。值为 0 会导致 Sublime Text 根据 CPU 内核数自动选择进程数。

默认值: 0

"index_exclude_gitignore" 布尔值🔗
4050

如果通过 .gitignore 忽略的文件从索引中排除。

默认值: true

"index_skip_unknown_extensions" 布尔值🔗
4050

如果扩展名未知的文件从索引中排除

默认值: true

"index_exclude_patterns" 字符串数组🔗

用于从索引中排除文件的文件模式

默认值: ["*.log"]

"show_definitions" 布尔值🔗

如果已为某个单词建立索引,则将鼠标悬停在该单词上时,是否会显示“转到定义”弹出窗口。

默认值: true

"auto_complete_use_index"🔗
4050

自动完成是否应使用索引中的信息。

默认值: true