PyCharm 2025.3 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. 复制 窗口中,选择您需要的路径或引用。

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

  • 选择 全字匹配单词 图标 )或 区分大小写区分大小写 图标 )等选项,以在项目中查找精确单词或匹配字母大小写。

  • 选中 正则表达式 图标 后,在搜索包含这些符号的文本字符串时,PyCharm 会使用反斜杠 \ 自动转义特殊的正则表达式符号。

    有关 正则表达式 的更多信息,请参阅 使用正则表达式进行搜索 文档。

  • 点击 筛选 图标以筛选搜索。 例如,您可以通过筛选来忽略注释,或仅在注释中进行搜索。

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

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

    在类层次结构中搜索

    如果您在不使用选项卡的情况下工作,范围 最近查看的文件最近更改的文件 选项可能会很有用。 您也可以创建自定义范围,点击 浏览 图标(省略号图标 )以打开 Scopes 对话框。

在特定文件类型中搜索

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

  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年 12月 2日