Python怎么定义函数:def语法结构与基础示例

Ivy
Ivy
发布时间:2026-11-19| 5人浏览过
原创

详细讲解Python中如何使用def关键字定义函数,包括基本语法结构、参数传递、return返回值、编写步骤以及初学者常见错误排查与基础示例。

在 Python 中,定义一个函数需要使用关键字 def(即 define 的缩写)。函数是一段被赋予名称并封装起来的代码块,能够接收外部传入的参数、执行一系列逻辑操作,并通过 return 将计算结果返回给调用者。理解 def 的语法结构、缩进机制与参数流转,是编写模块化、可复用 Python 代码的基础。

一、def 核心语法结构拆解

Python 中定义函数遵循固定而清晰的结构。一行标准的函数声明语句由 def 关键字、自定义函数名、包围形参的小括号以及末尾的英文冒号组成,随后接缩进的代码块作为函数体。

Python怎么定义函数:def语法结构与基础示例
图 1:Python def 语句语法元素与内部布局

具体语法规则说明如下:

  • def 关键字:向 Python 解释器声明接下来是一个函数定义,属于保留关键字。
  • 函数名称:紧跟在 def 之后,需满足标识符命名规则(不能以数字开头,不能包含特殊符号),推荐采用全小写加下划线的蛇形命名法(如 calculate_total)。
  • 参数列表:放在括号 () 内。即便函数无需任何入参,一对小括号也是必不可少的。
  • 末尾冒号 ::标明声明头部结束,下一行将开启函数代码块。这是初学者最容易遗漏的符号。
  • 缩进函数体:Python 依靠缩进区分代码层级,函数体内的所有语句必须统一向右缩进(标准为 4 个空格)。
  • return 语句:用于结束函数执行并将指定结果返回;如果省略,函数在执行完毕后自动返回 None。

二、编写与调用函数的完整四步流程

从无到有实现一个可用函数,通常包含需求拆解、函数声明、返回值处理和外部调用验证四个步骤。

Python怎么定义函数:def语法结构与基础示例
图 2:编写与调用 Python 函数的标准四步流程

下面通过一个计算矩形面积的具体代码示例,演示四步操作的落地方式:

# 步骤 1 & 2: 声明函数名与形参(长 width、宽 height),并保持 4 个空格缩进
def calculate_rectangle_area(width, height):
    """计算矩形面积并返回数值。"""
    # 步骤 3: 计算并使用 return 传出结果
    area = width * height
    return area

# 步骤 4: 在函数外部进行调用,传递具体数值并用变量接收
result1 = calculate_rectangle_area(10, 5)
result2 = calculate_rectangle_area(7.5, 3)

# 打印验证结果
print("长10宽5的矩形面积:", result1)
print("长7.5宽3的矩形面积:", result2)

运行上述代码后,终端输出的示例结果如下:

长10宽5的矩形面积: 50
长7.5宽3的矩形面积: 22.5

三、函数调用原理与数据流转机制

调用函数时,程序执行流程会从当前上下文跳转进入函数的独立作用域内,执行完毕后再带着结果返回原调用点。

Python怎么定义函数:def语法结构与基础示例
图 3:函数调用生命周期与作用域数据传递机制

1. 形参与实参的绑定

定义函数时的变量名为形参(形式参数),而实际调用时传入的具体对象称为实参(实际参数)。Python 采用“对象引用传递”机制,在进入函数时形参名会指向对应的实参对象。

2. 默认参数与位置参数

可以为形参指定默认值。如果在调用时没有传递该参数,函数会自动采用预设默认值;有默认值的参数必须放在无默认值参数之后:

def greet(name, prefix="你好"):
    return f"{prefix},{name}!"

# 不提供 prefix,采用默认值
print(greet("张三"))          # 输出:你好,张三!

# 显式提供 prefix,覆盖默认值
print(greet("李四", "欢迎光临")) # 输出:欢迎光临,李四!
重要注意事项:切勿将可变对象(如空列表 [] 或空字典 {})作为函数的默认参数。因为默认参数在函数定义阶段仅求值一次,多次调用若修改该可变对象,会导致不同调用之间的数据串扰。如需默认列表,应将形参默认值设为 None,并在函数内部判断并重新赋值。

四、常见报错排查与速查总结

初学者在编写函数时,通常会遇到四类高频报错。对照下表与速查卡片能够快速定位原因:

  • SyntaxError: expected ':':定义函数末尾忘记写英文半角冒号。
  • IndentationError: expected an indented block:def 语句下方没有对函数体进行缩进,或者缩进混用了 Tab 与空格。
  • TypeError: missing required positional argument:调用函数时传入的实参数量少于必填形参数量。
  • NameError: name 'xxx' is not defined:在函数外部直接访问了函数内部定义的局部变量。
Python怎么定义函数:def语法结构与基础示例
图 4:Python 函数定义规范与避坑速查卡

总结而言,在 Python 中使用 def 定义函数并不复杂,核心在于把控好“关键字、名称、入参、冒号、缩进与返回值”六个基本要素。养成良好命名习惯并遵守局部作用域规范,能让编写的函数兼具清晰度与高复用性。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。