python怎么定义函数def基本语法是什么

许南星
许南星
发布时间:2026-11-21 | 5人浏览过
原创

全面解析 Python 语言中定义函数的核心语法 def。从关键字声明、函数命名规则、形参与默认参数配置,到缩进规范与 return 返回值机制,结合直观图示、代码示例与高频避坑指南,助你彻底掌握 Python 函数基础。

Python基础语法 适用版本:Python 3.x 内容类型:核心语法与实践规范
python怎么定义函数def基本语法是什么

【速览概览】Python def 函数定义的基本语法框架与核心组成

在 Python 中,定义一个函数需要使用保留关键字 def(英文 define 的缩写),其最基础的语法形式为: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。
python怎么定义函数def基本语法是什么

图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. 步骤 1(语法检查与对象生成):当 Python 解释器自上而下运行到 def 语句行时,会对该行的语法(括号配对、冒号存在性)进行合规性校验。如果合规,解释器会生成一个 function 类型的函数对象。
  2. 步骤 2(名称绑定到命名空间):生成的函数对象会被绑定到当前的命名空间中(例如全局变量字典 globals()),函数名其实就是一个指向该函数对象的引用变量。此时函数体内部的代码完全不会被执行。
  3. 步骤 3(发起调用与实参接收):只有在后续代码中显式通过 函数名(参数) 的形式带上圆括号调用时,解释器才会正式触发该函数的内部逻辑。此时调用方传入的实参会与形参完成匹配与赋值。
  4. 步骤 4(压入调用栈并开辟局部帧):Python 运行时会为当前调用分配独立的栈帧(Stack Frame)和局部作用域(Local Scope),函数体内新建的变量仅存活在该栈帧中,与外部变量天然隔离。
  5. 步骤 5(执行语句与返回结果):函数逐行执行缩进代码。当遇到 return 语句或执行到函数末尾时,栈帧弹出销毁,控制权与返回值交回给调用代码。
python怎么定义函数def基本语法是什么

图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()。
python怎么定义函数def基本语法是什么

图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 的语法并不困难,难点在于养成严谨整洁的编写习惯。在实际开发中,建议在每次完成函数声明后,依照以下核心清单快速自检:

python怎么定义函数def基本语法是什么

图4:Python def 函数定义核心语法速查与避坑全景总结

综上所述,Python 定义函数的基本语法可以浓缩为一句话:以 def 声明、英文圆括号承载参数、英文冒号收尾,配合统一的 4 格缩进构建执行体,并根据业务需求用 return 交出结果。只要守住参数排布顺序、避免可变默认值,并写好直观的文档注释,写出的函数就能兼具高度的健壮性与可读性。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表