python怎么定义函数def基本语法是什么
全面解析 Python 语言中定义函数的核心语法 def。从关键字声明、函数命名规则、形参与默认参数配置,到缩进规范与 return 返回值机制,结合直观图示、代码示例与高频避坑指南,助你彻底掌握 Python 函数基础。
【速览概览】Python def 函数定义的基本语法框架与核心组成
def 函数名(参数列表):。在声明头之后,必须换行并保持统一的 4 个空格缩进来书写函数体代码;当需要将运算结果传递回调用者时,使用 return 语句返回结果。若省略 return,函数执行完毕后将默认隐式返回 None。
无论是编写几行代码的小脚本,还是构建大型工业级后端服务,函数都是 Python 程序组织逻辑、消除重复代码的最基础构建块。初学者在刚接触 def 时,常常会因为冒号遗漏、缩进不规范或参数默认值的错误配置而遭遇报错。本文将完整拆解 def 的语法结构、执行全生命周期、传参机制与高频避坑规则。
一、def 关键字与基础语法结构拆解
在 Python 中,声明函数的骨架语法非常简洁。完整的定义形式如下所示:
def 函数名称(形参1, 形参2=默认值):
"""可选的函数文档字符串(Docstring),解释函数作用与参数"""
# 4个空格缩进的函数逻辑处理块
执行语句1
执行语句2
return 返回结果
从语法构成上看,一个合法的 Python 函数定义包含以下 6 个核心要素:
- def 关键字:Python 固定的语法标记,告诉解释器“当前正在声明一个新函数”,其后必须留有一个半角空格。
- 函数标识符(函数名):遵循 Python 变量命名规则,必须以字母或下划线开头,由字母、数字和下划线组成。按照官方 PEP 8 规范,普通函数推荐使用小写字母加下划线的“蛇形命名法”(如
calculate_total、get_user_info)。 - 圆括号与形参列表
(...):括号紧随函数名之后,哪怕函数完全不需要外部传入任何参数,一对空的半角圆括号()也是绝对不能省略的语法要求。 - 行末英文冒号
::圆括号后必须紧接一个英文半角冒号。在 Python 语法体系中,冒号是引导下一行“缩进代码块”的关键定界符。 - 缩进的函数体(Indentation):Python 不像 C/Java 等语言使用花括号
{}圈定代码范围,而是完全依赖缩进。函数体内的所有语句必须保持相同层级的缩进(标准规范为 4 个英文空格)。 - return 返回值语句:用于终止当前函数的执行,并将指定结果交还给调用处。
return是可选的,若没有书写或仅写了return而未带值,函数将返回None。
图1:Python def 函数定义语句的 6 大语法要素剖析与对应关系
下面是一个符合生产级规范的基础示例——计算商品打折后的实际价格:
def calculate_price(original_price, discount_rate=0.9):
"""
计算商品实付价格
:param original_price: 商品原价(数值)
:param discount_rate: 折扣率,默认为 0.9(九折)
:return: 计算后的最终实付金额
"""
final_amount = original_price * discount_rate
return round(final_amount, 2)
# 实际调用验证
pay1 = calculate_price(200) # 使用默认折扣 0.9 -> 输出 180.0
pay2 = calculate_price(200, 0.8) # 自定义八折 -> 输出 160.0
print("实付金额 1:", pay1)
print("实付金额 2:", pay2)
二、函数从定义到调用的完整执行步骤
很多初学者容易误以为“代码写了 def 就会立刻运行里面的逻辑”。事实上,在 Python 解释器的运行机制中,“定义函数”与“调用执行”是两个阶段完全独立的操作过程:
- 步骤 1(语法检查与对象生成):当 Python 解释器自上而下运行到
def语句行时,会对该行的语法(括号配对、冒号存在性)进行合规性校验。如果合规,解释器会生成一个function类型的函数对象。 - 步骤 2(名称绑定到命名空间):生成的函数对象会被绑定到当前的命名空间中(例如全局变量字典
globals()),函数名其实就是一个指向该函数对象的引用变量。此时函数体内部的代码完全不会被执行。 - 步骤 3(发起调用与实参接收):只有在后续代码中显式通过
函数名(参数)的形式带上圆括号调用时,解释器才会正式触发该函数的内部逻辑。此时调用方传入的实参会与形参完成匹配与赋值。 - 步骤 4(压入调用栈并开辟局部帧):Python 运行时会为当前调用分配独立的栈帧(Stack Frame)和局部作用域(Local Scope),函数体内新建的变量仅存活在该栈帧中,与外部变量天然隔离。
- 步骤 5(执行语句与返回结果):函数逐行执行缩进代码。当遇到
return语句或执行到函数末尾时,栈帧弹出销毁,控制权与返回值交回给调用代码。
图2:Python 函数从“声明编译”到“调用执行”的完整生命周期
如果函数尚未完成逻辑编写,但为了保证代码结构完整、不产生编译语法错误,可以使用内置关键字 pass 进行占位:
def fetch_remote_data(api_url):
# 占位声明,保证代码运行不报错
pass
三、形参与实参:参数形式与返回值逻辑
掌握了 def 的声明骨架后,函数实用性的核心就在于“如何输入数据(参数)”以及“如何输出数据(返回值)”。
1. 位置参数与默认参数
在定义函数时,圆括号中的变量称为形参(形式参数)。参数主要有以下几种基础形态:
- 位置参数:没有设定默认值的必填参数。调用时传入实参的顺序必须与定义时的形参顺序完全一致。
- 默认参数:形参后带有
= 默认值。调用方可以选择不传递该参数,此时将自动采用预设默认值;若传递了实参,则覆盖默认值。
def 参数列表中,所有没有默认值的非默认参数必须严格排在所有默认参数之前。例如 def fn(a, b=10): 是合法的,而 def fn(a=10, b): 会直接抛出 SyntaxError: non-default parameter follows default parameter 错误。
2. 关键字实参的灵活匹配
在调用函数时,除了按照位置按序传参,Python 还允许通过 形参名=值 的方式指定传参,这称为关键字实参。使用关键字实参时,参数的书写顺序可以任意调换:
def format_user_profile(name, age, city="北京"):
return f"姓名: {name}, 年龄: {age}, 城市: {city}"
# 方式 1:标准位置传参
res1 = format_user_profile("张三", 25)
# 方式 2:关键字传参,可调整顺序
res2 = format_user_profile(age=28, name="李四", city="上海")
3. return 返回值的运行机制
return 语句决定了函数的输出与控制流终止。关于 return 有三个核心规律必须牢记:
- 提前截断:只要执行流程遇到了
return,函数就会立刻退出,其下方所有同层级的代码将被直接跳过。 - 缺省返回 None:如果函数没有写
return,或者写了空的return,Python 都会在执行到底部时返回None。 - 多值返回本质:当书写
return a, b, c时,Python 实际上自动将它们打包成了一个元组(a, b, c)进行返回。接收端可以直接使用逗号解包获取:x, y, z = get_coords()。
图3:Python 函数参数传递与返回值流动机制对比
四、初学者最常遇到的 4 个语法陷阱与排查
在日常编写 def 函数时,初学者经常遭遇以下几类典型报错,定位并修正它们其实非常直接:
| 常见错误表现 | 错误根源分析 | 正确写法与排查对策 |
|---|---|---|
SyntaxError: expected ':' |
函数头定义行末尾漏写了半角冒号 :,或者误输入成了中文全角冒号 :。 |
检查 def func(): 行尾,确保使用的是英文半角冒号。 |
IndentationError: expected an indented block |
def 下一行没有做缩进,或者缩进层级不一致(混用了 Tab 和空格)。 |
统一使用编辑器自动转换为 4 个空格缩进;若暂时不需要写逻辑,在函数体内写 pass。 |
SyntaxError: non-default parameter follows default parameter |
将必选的无默认值形参写在可选的默认形参之后。例如:def f(x=1, y):。 |
重构参数顺序,将所有带有默认值的参数放置在参数列表的最后方:def f(y, x=1):。 |
| 默认参数值“异常累积” | 使用了可变对象作为默认参数(如 def add_item(item, lst=[]):)。默认参数在函数定义时仅初始化一次。 |
可变对象默认参数采用 None 占位,在函数体内进行初始化:if lst is None: lst = []。 |
其中第四项“可变默认参数陷阱”最为隐蔽。以下对比展示了其严重后果与标准防护手段:
# ❌ 错误示范:使用可变对象 [] 作为默认参数
def append_wrong(val, container=[]):
container.append(val)
return container
print(append_wrong(1)) # [1]
print(append_wrong(2)) # [1, 2] <- 原本希望每次是新列表,却共享了历史数据!
# ✔ 标准正确做法:默认值设为 None,内部按需新建
def append_correct(val, container=None):
if container is None:
container = []
container.append(val)
return container
print(append_correct(1)) # [1]
print(append_correct(2)) # [2] <- 各调用互不干扰
五、核心规范与编写清单总结
掌握 def 的语法并不困难,难点在于养成严谨整洁的编写习惯。在实际开发中,建议在每次完成函数声明后,依照以下核心清单快速自检:
图4:Python def 函数定义核心语法速查与避坑全景总结
综上所述,Python 定义函数的基本语法可以浓缩为一句话:以 def 声明、英文圆括号承载参数、英文冒号收尾,配合统一的 4 格缩进构建执行体,并根据业务需求用 return 交出结果。只要守住参数排布顺序、避免可变默认值,并写好直观的文档注释,写出的函数就能兼具高度的健壮性与可读性。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









