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