PyCharm 2025.1 Help

提取形参

提取参数重构用于向函数声明中添加新参数,并相应地更新函数调用。

就地提取 Python 参数

就地重构在 PyCharm 中默认启用。 因此,如果您未更改此设置,Python 的“提取参数”重构将在编辑器中就地执行:

  1. 在编辑器中,将插入符号放置在要替换为参数的表达式内。

  2. 请执行以下操作之一:

    • 按下 Ctrl+Alt+P

    • 在主菜单中选择 重构 | 提取/引入 | 参数

    • 请选择 重构 | 引入参数

  3. 如果在当前插入符号位置检测到多个表达式,将显示 表达式 列表。 如果是这种情况,请点击表达式以选择它。 或者,按 运行 向下 导航到感兴趣的表达式,然后按 Enter 选择它。

    提取形参
  4. 在带有红色边框的框中输入参数名称。

    输入参数名称
  5. 要完成重构,请按 TabEnter

    如果您尚未完成重构并希望取消所做的更改,请按 Escape

    请注意,有时您可能需要多次按下相应的键。

使用“提取参数”对话框提取参数

要使用 提取形参 对话框(而不是就地执行重构),请确保编辑器设置中 启用就地重构选项已关闭。

在这种情况下,您可以按以下步骤执行“提取参数”重构:

  1. 在编辑器中,将插入符号放置在要替换为参数的表达式内。

  2. 请执行以下操作之一:

    • 按下 Ctrl+Alt+P

    • 在主菜单中选择 重构 | 提取/引入 | 参数

    • 请选择 重构 | 引入参数

  3. 如果在当前插入符号位置检测到多个表达式,将显示 表达式 列表。 如果是这种情况,请点击表达式以选择它。 或者,按 运行 向下 导航到感兴趣的表达式,然后按 Enter 选择它。

  4. 在打开的 提取参数对话框中:

    1. 名称 字段中指定参数名称。

    2. 如果在函数体内找到表达式的多个实例,您可以选择仅替换选定的实例或将所有找到的实例替换为对新参数的引用。 使用 替换所有匹配项 复选框指定您的意图。

  5. 预览并应用更改

最后修改日期: 2025年 4月 23日