Python怎么定义函数：def语法结构与缩进规则详解

在Python中定义函数的核心机制非常直接：使用保留关键字 def 声明函数名称与参数列表，并在行尾使用英文冒号 : 引导随后的代码块，随后通过严格统一的四空格缩进书写具体的函数体逻辑。理解 def 语法构件与缩进规则，是编写规范、可维护Python程序的基石。

一、Python函数的标准def语法解构

在Python中，函数被视作组织好、可重复使用的代码单元。与许多使用花括号 {} 划定代码范围的语言不同，Python完全通过关键字、符号和排版布局来声明函数。一个完整的函数定义包含以下五个核心部分：

1. 关键字 def：即“define”的缩写，告知Python解释器当前行开始创建一个自定义函数对象。
2. 函数名称（Identifier）：紧随 def 之后，遵循标识符命名规范（通常建议使用小写字母配合下划线命名的 snake_case 风格）。
3. 参数圆括号 ()：用于接收调用端传入的数据。即使该函数无需任何参数，一对圆括号也必不可少。
4. 英文冒号 :：放置于声明行的最末尾，标志着函数头声明结束、函数体代码块即将开始。遗漏冒号是初学者最常见语法错误之一。
5. 缩进的函数体（Function Body）：包含可选的文档字符串（Docstring）、执行逻辑以及用于输出结果的 return 语句。

图1：Python函数声明的五个核心结构要素与语法布局

下面是一个标准的实际代码示例，演示如何定义并调用一个计算圆形面积的函数：

# 1. 函数定义部分
def calculate_circle_area(radius):
    """计算并返回圆形的面积"""
    pi = 3.141592653589793
    area = pi * (radius ** 2)
    return area

# 2. 函数调用部分（顶格书写，脱离函数体）
r = 5.0
result = calculate_circle_area(r)
print(f"半径为 {r} 的圆面积为: {result}")

示例输出：

半径为 5.0 的圆面积为: 78.53981633974483

二、从零构建并调用函数的标准步骤

在日常开发中，编写一个工作正常的Python函数通常遵循固定的四个操作步骤。清晰的流程有助于规避未声明先调用或缩进混乱等问题。

图2：定义与调用Python函数的四个基本步骤

以下是这四个步骤的具体操作说明与要点：

• 步骤一：设计函数签名。确定函数要做什么，为其起一个语义明确的名字，并列出需要传入的参数名。
• 步骤二：实现函数体。按回车换行后输入4个空格作为基础缩进，处理业务计算，并依据需要使用 return 产出计算结果。如果函数没有 return 语句，Python会隐式返回 None。
• 步骤三：解除缩进结束定义。函数编写完毕后，新的主程序逻辑代码必须回退到与 def 同级的缩进层次（若在模块顶层，即回退至首列顶格）。
• 步骤四：传入实参发起调用。在函数定义生效之后，通过 函数名(实际参数) 进行触发，若有返回值可用变量接收。

三、核心缩进规则与代码块作用域

缩进是Python语法的核心机制。Python不依赖 begin...end 或 {...} 来标识作用域，而是强制通过缩进量判断代码的归属关系。理解缩进必须牢记以下三条硬性规则：

1. 规则一：层级决定归属

冒号后的下一行代码必须缩进。只要后续代码行保持与首行相同的缩进深度，它们就属于同一个代码块。一旦某一行的缩进量减少（Dedent），前一个代码块即宣告终结。

2. 规则二：统一使用4个空格，严禁混用Tab与空格

PEP 8（Python官方代码风格指南）明确要求使用 4个英文半角空格 表示一级缩进。在不同文本编辑器中，Tab制表符可能被展示为2、4或8个字符宽。如果混用Tab与空格，在人类肉眼下看似整齐，但在Python词法分析器眼中属于不同的缩进长度，会直接抛出语法致命错误。

3. 规则三：嵌套结构同级必须对齐

当函数内部包含条件判断（if）、循环（for/while）等复合语句时，每增加一层复合语句，代码就要在现有基础上再增加4个空格的缩进。同属于一个分支下的语句，缩进必须像素级对齐。

图3：多层嵌套下的缩进深度与代码块闭合边界

四、常见缩进与语法报错排查

在编写函数时，若缩进或标点存在偏差，Python解释器在词法分析阶段就会阻断执行并抛出异常。以下三种错误最为高发：

def fetch_remote_data():
    pass  # 缩进的占位语句，保证语法完整性

五、参数与返回值的典型设计范式

函数不仅能够复用逻辑，更是程序内数据流通的桥梁。Python的函数参数和返回值设计具有高度灵活性，掌握常见参数形态能够大幅提升函数的可用性。

图4：参数默认值、关键字传参与多返回值打包机制

以实际场景为例，下面的函数展示了如何结合默认参数与多值返回：

def split_full_name(full_name, reverse=False):
    """
    根据空格切分全名并返回（名, 姓）。
    参数 reverse 若为 True，则翻转返回（姓, 名）。
    """
    parts = full_name.strip().split(" ", 1)
    first_name = parts[0]
    last_name = parts[1] if len(parts) > 1 else ""
    
    if reverse:
        return last_name, first_name
    return first_name, last_name

# 场景1：使用默认参数
fn, ln = split_full_name("Guido Rossum")
print(f"名: {fn}, 姓: {ln}")

# 场景2：指定关键字参数
ln2, fn2 = split_full_name("Guido Rossum", reverse=True)
print(f"姓: {ln2}, 名: {fn2}")

示例输出：

名: Guido, 姓: Rossum
姓: Rossum, 名: Guido

六、函数定义的总结与最佳实践

熟练掌握Python函数不仅在于写出无语法错误的 def，更在于保持结构规整、作用域清晰。总结日常开发中的关键要点如下：

• 标点不能忘：def 函数名(参数): 结尾的冒号是开启代码块的法定标记。
• 坚持四空格：在现代IDE（如VS Code、PyCharm）中将缩进统一配置为“Insert Spaces = 4”，杜绝制表符混用。
• 作用域最小化：在函数内部创建的局部变量在函数退出后立即释放，避免在函数内随意修改全局状态。
• 编写说明文档：在函数体首行编写三引号文档字符串 """Docstring"""，明确说明该函数的用途、参数类型及返回值意义。

只要遵循这些标准模式，编写结构严谨、执行高效的Python函数就会成为一种自然而然的编程习惯。