PyCharm 2025.2 Help

重命名重构

使用 重命名 重构更改符号、文件、变量、函数、包、模块及其在整个代码中的所有引用的名称。

重命名局部变量或函数可以轻松地内联完成,因为只会影响有限的范围。 重命名类或其方法可能会影响许多文件。 在重构之前预览潜在的更改。

内联重命名代码元素

  1. 将插入符号放在您想要重命名的元素上,然后按 Shift+F6

    如果此元素在注释、字符串或文本文件中有出现,则会显示内联图标:

    重命名选项的内联图标
  2. 点击图标并选择所需的选项:

    内联重命名重构的选项

    要打开 重命名对话框 ,请点击 更多选项 或再次按 Shift+F6

  3. 输入元素的新名称。 所有出现的地方将自动更改:

  4. TabEnter 应用重构。 如果有需要您注意的更改,PyCharm 会打开 查找 工具窗口,您可以在其中检查结果并通过点击 执行重构 确认重构。

使用快速修复或边距图标

  1. 在编辑器中开始重命名代码元素。 PyCharm 将会显示 重命名 图标 的用法 在装订区域。

  2. 点击代码区图标或按 Alt+Enter 并应用建议。

    重命名内联

    PyCharm 重命名代码元素,并相应地更新其用法。

    重命名重构结果

重命名目录或模块

  1. 项目工具窗口 中右键点击您要重命名的目录或模块。

  2. 从上下文菜单中选择 重命名Shift+F6)。

  3. 在弹出的 重命名 对话框中,输入新名称,指定其他选项和重构范围,然后点击 重构(R)

使用重命名对话框

  1. 在编辑器中选择您要重命名的元素。 如果您需要重命名文件,请在 项目 工具窗口中选择一个。

  2. Shift+F6 或右键点击并从上下文菜单中选择 重命名

  3. 您可以执行 内联重命名重构 ,或者再次按 Shift+F6 打开 重命名 对话框。 输入元素的新名称以启用 预览重构 按钮。

    重命名对话框

    您可以指定其他选项。 例如,指定在哪里搜索元素的出现,或要重命名什么。 您还可以指定重构的范围。

  4. 点击 预览 查看潜在的更改或点击 重构

    当您点击 预览 时,PyCharm 会打开 查找工具窗口,显示找到的用法,您可以在其中检查结果并确认重构(执行重构)。

下次您调用 重命名 重构时,PyCharm 会记住您在 重命名 对话框中指定的选项。

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