Python函数定义基础语法：def关键字与代码缩进规范

一、def 关键字的核心含义与函数基本骨架

Python 是一门语法高度凝练的动态语言。关键字 def 是 define（定义）的缩写，它是 Python 语言层面的保留保留字，专门用于向解释器声明一个新函数的开始。当解释器扫描到 def 语句时，会在内存中创建一个函数对象（Function Object），并将其与指定的函数名绑定到当前的局部或全局命名空间中。

一个标准的 Python 函数由头部声明与缩进执行体两大部分组成。其基础语法骨架如下：

def <函数名>(<参数1>, <参数2>, ...):
    """可选：函数文档字符串 (Docstring)"""
    <执行语句 1>
    <执行语句 2>
    return <返回值>

在构建函数头部时，开发者需要遵守四个关键句法要素：

• 关键字固定全小写：必须严格拼写为小写字母 def，使用 Def 或 DEF 会直接触发 SyntaxError。
• 函数名标识符规范：遵循 PEP 8 推荐的 snake_case（小写蛇形命名法），由字母、下划线和数字组成，且首字符严禁为数字，同时不可使用 class、for 等保留关键字。
• 参数圆括号不可省略：即使函数不需要接收任何外界输入参数，函数名后也必须保留一对紧邻的空圆括号 ()。
• 半角英文冒号结尾：括号后必须紧接一个英文半角冒号 :。在 Python 语法体系中，冒号是复合语句头部的终结符号，用于引出下一级代码块。

紧随冒号下方的第一行通常推荐编写由三引号包含的文档字符串（Docstring）。它用于阐释函数的功能设计、各参数类型含义以及返回数据结构。文档字符串会被自动绑定到函数对象的 __doc__ 属性中，能够直接被内置函数 help() 以及现代 IDE 实时解析为悬浮帮助信息。

二、代码缩进机制：越位规则与 PEP 8 缩进规范

与 C、C++、Java 等语言使用花括号 {} 界定逻辑块不同，Python 采用了被称为“越位规则”（Off-side Rule）的语法机制。在 Python 中，缩进不是代码的美化修饰，而是具有严格语法强制力的作用域界定符。

1. 为什么是 4 个空格

根据 Python 官方编码规范 PEP 8 的明确规定，Python 源代码中的每一级缩进应当固定使用 4 个标准空格（Four Spaces per Indentation Level）。4 个空格在终端和各类编辑器中具有适中的可视辨识度，既能清晰展示代码的层级嵌套深度，又不会因为缩进过深导致单行代码长度迅速超出 79 字符的规范限制。

2. 严禁混用制表符（Tab）与空格

在不同的操作系统、文本编辑器或终端环境下，制表符 对应的视觉宽度各不相同（常见为 2、4 或 8 个字符）。如果在同一份代码文件中混用了 Tab 键与空格，在屏幕上看似整齐对齐的代码，其底层的 ASCII/Unicode 字符码完全不同。

Python 3 解释器对此采取零容忍策略，一旦检测到同一逻辑块中混存空格与 Tab，会立即中断执行并抛出 TabError: inconsistent use of tabs and spaces in indentation。因此，在开发环境中，必须将编辑器的 Tab 键行为配置为“按 Tab 插入 4 个空格”（Insert Spaces）。

3. 退格对齐与函数作用域终止

既然没有类似 end 或 } 的闭合标记，解释器如何判定函数何时结束？答案就是退格（Unindent）。只要后续行的行首空白缩进回退到与 def 相同的层级（通常是文件顶格或上一级外层结构），就标志着当前函数的代码块彻底结束。

三、编写与执行 Python 函数的完整操作步骤

下面通过一个带参数校验与结果计算的实用示例，完整展示编写、定义和调用一个 Python 函数的标准流程。

步骤 1：确定函数职责与输入输出签名

在动笔之前，明确函数需要完成的独立任务。例如，我们需要设计一个计算“商品含税总价”的函数 calc_invoice_total，它接收商品单价 price、购买数量 quantity 和税率 tax_rate，并返回最终结算金额。

步骤 2：书写函数头与定界冒号

在文件顶格书写小写 def，紧接着函数名及参数，并附带默认税率参数 tax_rate=0.08，末尾补齐半角冒号：

def calc_invoice_total(price, quantity, tax_rate=0.08):

步骤 3：严格以 4 空格缩进编写函数体

回车换行后按 4 个空格对齐，编写文档注释、基础入参校验、浮点计算逻辑，并通过 return 将最终结果传出：

def calc_invoice_total(price, quantity, tax_rate=0.08):
    """计算订单含税总价。
    
    参数:
        price (float): 单价，必须大于0
        quantity (int): 购买数量，必须大于0
        tax_rate (float): 税率，默认 0.08 (8%)
    
    返回:
        float: 保留两位小数的含税总金额
    """
    if price <= 0 or quantity <= 0:
        return 0.0

    subtotal = price * quantity
    total = subtotal * (1 + tax_rate)
    return round(total, 2)


# 退格到顶格位置，脱离函数定义块，开始执行主调流程
item_price = 120.0
item_count = 3
final_amount = calc_invoice_total(item_price, item_count)

print("单价:", item_price)
print("数量:", item_count)
print("结算总额:", final_amount)

步骤 4：运行脚本并验证输出结果

在系统终端中使用 Python 解释器执行上述代码文件，输入与输出清晰隔离：

四、空函数与 pass 语句的规范占位

在项目架构设计、原型开发或接口抽象阶段，开发者经常需要先搭建代码骨架，后续再补充具体实现。但在 Python 语法中，冒号后必须紧随至少一行有效的缩进语句，直接留白会破坏 AST 抽象语法树的构建：

def sync_database_records():
    # 这里只写了注释，没有有效代码语句

def next_task():
    print("Next")

上述代码在运行时会直接抛出 IndentationError: expected an indented block after function definition。这是因为注释在词法分析阶段会被过滤，解释器在冒号后未能读取到缩进块。

正确的工程解决方案是在冒号下方缩进 4 个空格，写入 pass 语句或省略号 ...：

def sync_database_records():
    """待实现：定时同步数据库记录"""
    pass  # 有效占位语句，空操作（No-op），保证语法解析通过


def calculate_loss():
    ...   # 省略号字面量（Ellipsis），同样符合有效代码块要求

五、常见语法与缩进报错排查指南

初学者在定义函数时，绝大多数语法异常都集中在冒号遗漏和缩进不规范上。下表梳理了最常见的四类报错及其修复方案：

1. SyntaxError: invalid syntax（冒号遗漏或中文字符）

典型表现：解释器报错箭头精准指向函数头末尾括号处，提示 SyntaxError: invalid syntax。

排查修复：

• 检查函数签名末尾是否漏写了英文冒号 :。
• 检查是否不小心输入了中文输入法下的全角冒号 ：。全角字符在 ASCII 编码之外，解释器无法识别。

2. IndentationError: expected an indented block

典型表现：执行脚本时提示 IndentationError: expected an indented block after function definition on line X。

排查修复：

• 检查冒号下一行是否直接顶格书写了其他语句。
• 如果在函数体中暂时没有编写逻辑，必须显式补齐缩进 4 格的 pass 占位语句。

3. IndentationError: unindent does not match any outer indentation level

典型表现：代码退格时未对齐上一级的缩进基准线。

排查修复：某一行只缩进了 2 格或 3 格，而同级其他语句缩进了 4 格。打开代码编辑器的“显示空格和制表符”功能，将各行缩进严格校正为 4 的整数倍。

4. SyntaxError: 'return' outside function

典型表现：解释器在解析 return 语句时直接报语法错误。

排查修复：return 只能存在于函数体内部。如果 return 语句被错误地退格写在顶格位置，或者写在了模块顶层代码中，就会脱离函数上下文从而引发该报错。将其向右缩进 4 格归入函数体即可恢复正常。

六、日常开发规范速查清单

—— 本文遵循 Python PEP 8 语法标准与工业级编码规范编写 ——