PyCharm 2025.2 Help

在项目中查找和替换

您可以在项目中搜索文本字符串,使用不同的范围缩小搜索过程,排除某些项目,查找用法和出现位置。

在项目中查找搜索字符串

  1. Ctrl+Shift+F 或从主菜单中选择 编辑 | 查找 | 在文件中查找

  2. 在搜索字段中输入您的搜索字符串。 或者,您可以在编辑器中高亮显示要查找的字符串,然后按下 Ctrl+Shift+F ,或者从上下文菜单中选择 在文件中查找。 PyCharm 将高亮的字符串放入搜索字段。

    要查看以前的搜索列表,请按 Alt+Down

    如果您需要,请指定其他选项。

    在文件中查找

    PyCharm 列出了搜索字符串及包含它们的文件。 如果在同一行代码中多次找到搜索字符串,PyCharm 会将结果合并到一行。

    要进行多行搜索,请点击 多行搜索 图标以输入新行,然后按 Ctrl+Alt+Down/Ctrl+Alt+Up 以浏览所有出现的情况。

  3. 请在对话框的预览区域中查看结果,您可以替换搜索字符串或选择另一个字符串,再次按 Ctrl+Shift+F 并开始新搜索。

  4. 要在单独的工具窗口中查看重复项列表,请点击 打开查找窗口。 使用此窗口及其选项对结果进行分组、预览并进一步处理。

    如果您希望在 查找 工具窗口的单独选项卡中查看每个新的搜索结果,请在 在新标签页中打开结果(B) 对话框底部选择 在文件中查找 复选框。

复制找到的文件路径或引用

  1. 在搜索结果列表中,右键点击要复制路径的结果,然后点击 复制/引用

  2. 复制 窗口中,选择您需要的路径或引用。

您可以使用 在文件中查找 对话框中的不同选项来调整您的搜索过程。

  • 请选择选项,例如 词语“单词”图标 )或 区分大小写匹配大小写图标 ),以在项目中找到确切的单词或匹配字母大小写。

  • 当选择了 Regex 图标 时,PyCharm 在您搜索包含特殊regex符号的文本字符串时,会自动用反斜杠 \ 对其进行转义。

    如需了解有关 regex的更多信息,请参阅 search with regex文档。

  • 点击 过滤器 图标以筛选您的搜索。 例如,您可以过滤搜索以忽略注释或只在注释中搜索。

  • 请选择显示的选项之一,例如 模块目录 来限制您的搜索。

    此外,您可以选择 范围 选项,它为您的搜索提供一个列表。 例如,您可以将搜索范围仅限制为项目中的打开文件。

    在类层次结构中搜索

    如果您不使用选项卡,作用域选项 最近查看的文件最近更改的文件 可能会派上用场。 您还可以创建自己的自定义作用域,点击 浏览 图标 (省略号图标) 以打开 作用域对话框。

在特定文件类型中搜索

请使用 文件掩码 选项将搜索作用域缩小到特定文件类型。 您可以从列表中选择现有文件类型、添加新文件类型或添加额外的文件掩码语法以搜索具有特定模式的文件类型。

  1. 请前往 编辑 | 查找 | 在文件中查找 Ctrl+Shift+F

  2. 在文件中查找 对话框中,选中 文件掩码 复选框,并从文件类型列表中选择您需要的类型。

    文件掩码

    PyCharm 将搜索作用域限定为指定类型。

  3. 如果您在列表中找不到所需的文件类型,请在 文件掩码 字段中输入您的文件类型。

    您可以在搜索字段中手动添加文件掩码。 如果有必要,请使用逗号分隔多个文件类型。

在项目中搜索用法

您可以在整个项目或您设置的范围内搜索符号的用法。

  1. 请前往 编辑 | 查找 | 在文件中查找 Ctrl+Shift+F

  2. 选择您想要查找用法的符号。 请注意,您还可以扩展搜索以查找文件用法。

  3. 在主菜单中,前往 编辑 | 查找 | 查找用法 Alt+F7

  4. 请在 查找 工具窗口中查看结果。

    查找工具窗口

    您还可以从之前的 查找用法 操作中提取结果。 转到 编辑 | 查找 | 最近查找用法 并执行用法查询。

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

    查找工具窗口预览区域

    如果 PyCharm 未返回任何结果,它将显示一条消息,建议选择更多选项。 您可以点击链接或按 Ctrl+Alt+Shift+F7 打开 查找用法 对话框,在其中设置新的搜索范围。

    查找用法对话框

    例如,您可以将搜索范围设置为仅生产文件或仅打开的文件。

    要设置自定义 范围 ,请点击 省略号图标

  5. 完成设置新范围后,点击 查找

如果您希望 PyCharm 在单独的窗口中显示选定符号的用法,请按 Ctrl+Alt+F7。 您可以使用此窗口进行快速导航。

查找用法对话框

再次按相同的快捷键以在默认范围中查看用法。

禁用自动高亮显示用法

当您将文本光标放置在一个符号上时,IDE 会高亮显示该符号在当前文件中的所有用法。 使用 F3Shift+F3 快捷键在高亮符号之间导航。

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

  • 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 ,并清除 高亮显示插入符号处元素的用法 复选框。

当自动高亮功能被禁用时,将插入符号放在必要的符号上并按 Ctrl+Shift+F7。 这将突出显示当前文件中该符号的所有用法。

在项目中替换搜索字符串

  1. Ctrl+Shift+R编辑 | 查找 | 在路径中替换 )以打开 替换路径 对话框。

  2. 在顶部字段中输入您的搜索字符串。 在底部字段中输入要替换的字符串。

    替换路径对话框

    例如,如果您想为一个大型项目更换变量名,请使用 替换路径 而不是 重命名 重构,因为您的变量也可能出现在配置文件中。

  3. 点击一个可用的 替换(R) 命令。

最后修改日期: 2025年 9月 26日