PyCharm 2025.2 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年 9月 26日