PyCharm 2025.3 Help

更改签名

更改签名 重构将多种可应用于函数签名的不同修改合并在一起。 您可以使用此重构执行以下操作:

  • 更改函数名称

  • 添加、移除并重新排序参数

  • 为参数指定默认值

在更改函数签名时, PyCharm 会搜索该函数的所有用法,并更新所有可安全修改以反映更改的调用、实现以及重写替换。

添加参数

  1. 点击以红色高亮显示的 return 值。

  2. Alt+Enter 并选择 创建parameter '<parameter_name>'

  3. 更改签名 对话框中,调整参数设置或接受建议的设置。

  4. 点击 重构(R)

就地更改签名

您也可以在编辑器中输入时更改函数签名。

  1. 开始添加或编辑函数的参数。 PyCharm 会在装订区域显示 重构图标

    就地更改签名重构
  2. 点击装订区域中的图标,或按 Alt+Enter

    如果您正在添加新参数,PyCharm 会建议为其添加默认值,并更新用法。

    为参数添加默认值

    如果您正在编辑参数,PyCharm 会建议为您更新用法。

    更新参数的用法
  3. 点击 更新 以应用建议。

更改函数签名

  1. 将插入符号置于您要重构的函数名称处。

  2. Ctrl+F6。 或者,从主菜单或上下文菜单中选择 重构 | 更改签名

  3. 更改签名 对话框中,根据需要对函数签名进行必要的更改:

    更改签名动画
    • 更改函数名称。 要更改名称,请编辑 名称 字段中的文本。

    • 管理函数参数。 要配置参数,请使用 参数 区域中的表格和按钮:

      • 要添加新参数,请点击 添加按钮 ,并在相应的表格行中指定新参数的属性。

      • 要移除参数,请选择任意行并点击 移除按钮

      • 要重新排序参数,请点击 上移图标下移图标。 例如,如果您想将某个参数置于列表的首位,请点击该参数所在行的任意单元格,然后点击 上移图标 所需的次数。

      • 您可以为新添加的参数指定默认值。 请勿选择 在签名中使用默认值 复选框,以在现有调用中将指定的值用作显式占位符。

  4. 要在重构之前 查看预期的更改 并进行调整,请点击 预览

  5. 点击 重构

更改签名对话框

更改签名 重构将多种可应用于函数签名的不同修改合并在一起。 您可以使用此重构执行以下操作:

  • 更改函数名称

  • 添加、移除并重新排序参数

  • 为参数指定默认值

在更改函数签名时, PyCharm 会搜索该函数的所有用法,并更新所有可安全修改以反映更改的调用、实现以及重写替换。

说明

名称

函数、方法或方法规范的名称。

参数

签名中的参数列表。 在 参数 字段中,您可以对参数执行以下操作:

  • 添加 添加图标 :添加一个新参数。 您可以在相应的表格行中指定新参数的属性(名称、类型和默认值)。

  • 移除 移除图标 :移除参数。

  • 上移 上移图标下移 下移图标 图标:重新排序参数。

最后修改日期: 2025年 12月 2日