搜索用法

在文件中搜索用法

• 在编辑器中，点击您想要查找的元素；PyCharm 会自动高亮显示文件中找到的所有用法。 如果 用法高亮被禁用，请按 Ctrl+Shift+F7 来高亮文件中的所有用法。

  

• 要 查找文本字符串 ，请在编辑器中选择它，然后转到 编辑 | 查找用法 | 在文件中查找用法 Ctrl+F7。 PyCharm 会选择文件中所有用法的出现位置。

  

使用 F3 和 Shift+F3 快捷键在高亮符号之间导航。

在项目中搜索用法

• 选择您要查找用法的符号，右键点击该符号，然后从其上下文菜单中选择 查找用法 或按 Alt+F7。

  请在 Find 工具窗口中检查结果。

  如果您需要，您可以按文件、包、目录等分组( )结果。

  要打开 查找用法 对话框，请点击 工具栏中的 查找 工具窗口，或按 Ctrl+Alt+Shift+F7。

  PyCharm 分析搜索结果，检测最常见的使用模式，并根据其结构相似性将所有找到的用法分类到不同的组中。 这些使用集群出现在 预览 选项卡中。

  您可以从列表中选择任何组节点，然后点击 显示相似用法 以查看结果。

  要禁用此功能，请清除 在“查找用法”视图中启用相似用法聚类 复选框，位于 高级设置中。

  在 查找 工具窗口中，您还可以使用 预览 区域来检查找到用法的位置，以查看方法的调用层次结构、字段的数据流等等。

  

预览找到的用法的源代码

您有多种选项可以查看找到的用法的源代码。

1. 选择您要查找用法的符号，右键点击该符号，然后从其上下文菜单中选择 查找用法 或按 Alt+F7。

2. 在 查找 工具窗口中，点击 预览源 图标。

   作为替代，您可以选择 跳转到源 ，如果您在找到的用途中调用上下文菜单，或 在拆分中显示。 在这种情况下，包含结果使用情况的文件会在编辑器中打开。

在单独窗口中显示用法

您可以在一个单独的窗口中查看所选符号的用法，您可以将该窗口移动到屏幕的不同部分，以便快速导航。

1. 在编辑器中，选择您想查看用法的符号。

2. 请前往 编辑 | 查找用法 | 在代码中显示用法 Ctrl+Alt+F7。

   

   用法窗口显示当前范围和用法总数。 如果您想快速切换到默认范围，请按 Ctrl+Alt+F7。

   如果搜索结果包含太多条目，那么 PyCharm 会显示前一百个找到的用法，并在窗口底部显示 更多用法 选项，您可以点击以显示另一百个用法，如此类推，直到搜索完成。

   使用窗口顶部的过滤器来显示或隐藏特定的搜索条目。

查看最近使用的搜索结果

PyCharm 会记住您的 查找用法 结果，因此您不需要再次运行该操作。

• 在主菜单中，前往 编辑 | 查找用法 | 最近的查找用法 然后选择使用查询。

管理 Find Usages 的作用域

有时，您可能希望仅在项目的某些文件或库中查找用法。

1. 按 Ctrl+Alt+Shift+F7 打开 查找用法 对话框。

2. 在 查找用法 对话框中的 范围 字段，选择搜索的作用域。 例如，您可以仅在 打开文件 中搜索用法，或者仅在 项目测试文件 中搜索。

   

   您还可以通过点击 设置自定义 作用域。 例如，您可以创建一个自定义 scope 以排除某些文件，例如测试文件，从用法搜索中。 设置新的作用域后，点击 查找。

   如果 PyCharm 没有返回任何结果，将显示一条消息，建议您选择更多选项。

   

   您可以点击链接或按 Ctrl+Alt+Shift+F7 再次打开 查找用法 对话框，并为您的搜索设置一个新作用域。

禁用自动高亮显示用法

当您将文本光标放置在一个符号上时，IDE 会高亮显示该符号在当前文件中的所有用法。

如果有必要，您可以禁用自动高亮。

1. 按下 Ctrl+Alt+S 打开设置，然后选择 编辑器 │ 代码编辑。

2. 请清除 插入符号处元素的用法 复选框中的 文本光标移动时高亮 部分。

当自动高亮功能被禁用时，如果您想在当前文件中高亮显示一个符号的用法，请选择此符号并按下 Ctrl+Shift+F7。 这将突出显示当前文件中该符号的所有用法。

更改高亮显示用法的背景颜色

1. 在 设置 对话框 (Ctrl+Alt+S) 中，前往 编辑器 | 配色方案 | 常规。

2. 从右侧的选项中，打开 代码 节点并选择 光标下的标识符。

3. 请在 背景 字段中指定您需要的颜色并保存更改。