PyCharm 2026.1 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 会搜索该函数的所有用法,并更新所有可安全修改以反映更改的调用、实现以及重写替换。

项目

描述

名称

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

参数

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

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

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

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

2026年 3月 24日