python怎么写第一个函数并调用
本文详细讲解在Python中如何使用def关键字编写第一个函数并正确调用。涵盖函数基本语法结构、无参函数、参数传递、return返回值处理以及初学常见错误排查。
def 声明函数名称与参数列表,在缩进代码块中编写执行逻辑;调用时直接书写“函数名()”并在括号中传入必要参数。本文从最基础的无参函数语法讲起,逐步演示代码编写、终端运行、参数传递与返回值处理的完整操作链路,并针对初学者高频出现的 4 类运行报错给出排查方法。
一、理解函数的基本语法结构与要素规范
函数是组织好的、可重复使用的、用来实现特定功能的代码段。在 Python 中,所有常规函数都以 def 关键字开头(def 是 define 的缩写)。一个标准函数定义由五个核心要素组成:定义关键字、函数名称、形式参数列表(英文圆括号)、定界冒号以及具备严格缩进的函数体。
结合图 1 的语法拆解,每个要素在实际编写时有以下具体规则:
- 关键字 def:必须全小写。解释器读取到 def 时,会将其识别为函数定义语句,而不是普通变量赋值。
- 函数名标识符:遵循 Python 的变量命名规范(PEP 8 推荐使用下划线分隔的小写字母,即 snake_case)。函数名应具备描述性,让阅读者能从名字推断其功能,例如
greet、calculate_total等。 - 圆括号与参数列表:函数名之后紧跟一对英文半角圆括号
()。即使函数不需要接收任何外部输入,这对括号也是必选的。括号内部可以声明一个或多个用逗号隔开的形式参数(形参)。 - 定界冒号:圆括号末尾的冒号
:是 Python 语法定界符,不可遗漏。它标志着函数头声明结束,后续行正式进入函数体代码。 - 缩进代码块:Python 依靠缩进(统一推荐 4 个英文空格)来划定代码块的作用域。只有包含在缩进之内的语句才属于该函数。当缩进回到与 def 相同的层级时,即视为函数定义结束。
二、编写并运行你的第一个无参函数
最简单、最基础的函数是不带参数且不显式返回数值的函数。下面通过一个打印问候语的示例,演示完整的编写与调用过程。
1. 编写示例代码
使用任意文本编辑器(或集成开发环境 VS Code、PyCharm),新建一个名为 first_function.py 的文件,录入以下内容:
# 1. 定义函数
def say_hello():
print("你好!欢迎使用 Python 函数。")
# 2. 调用函数
say_hello()
say_hello() 是调用语句,它的行首没有缩进,与第 2 行的 def 顶格对齐。如果将调用语句也写在缩进内部,它就变成了函数体的一部分,导致文件运行时该语句不会被主动触发,甚至陷入无终止的自我递归。
2. 运行脚本并观察结果
在操作系统终端(Terminal 或命令提示符)中,进入保存该文件的目录,执行以下命令:
python3 first_function.py
当终端打印出上述文字时,表明你的第一个函数已经成功完成定义并顺利执行完毕。在底层,解释器按照图 2 所示的 4 个步骤完成了整个生命周期的流转。
在图 2 的执行流中,关键在于:
- 定义期不执行:当解释器初次读到
def say_hello():及其缩进体时,它仅仅在内存中创建函数对象并绑定名称,绝不会执行缩进体里的print语句。 - 调用期触发跳转:直到第 5 行遇到带有圆括号的
say_hello()时,解释器才暂停当前全局代码流,为该函数开辟专属调用栈帧,跳转进入函数体执行指令。 - 退出与控制权返回:函数体内的语句执行完毕后,调用栈帧被销毁,控制权重新交回主程序。
三、为函数增加参数:实现灵活的数据输入
现实开发中,函数往往需要根据外界传入的不同数据来执行计算或输出。这时需要在定义函数时在圆括号内声明“形式参数”(简称形参),在调用函数时传入具体的“实际参数”(简称实参)。
1. 声明带参函数并多次调用
新建文件 param_function.py,编写如下代码:
# 定义带一个参数的函数
def greet_user(username):
print(f"你好,{username}!很高兴见到你。")
# 传入不同实参进行多次调用
greet_user("张三")
greet_user("李四")
greet_user("王五")
2. 深入理解形参、实参与作用域隔离
结合图 3,初学者需要明确形参与实参在内存和作用域层面的两点核心机理:
- 引用绑定:当调用
greet_user("张三")时,解释器将字符串对象"张三"的引用传递给局部变量username。在函数体执行期间,username就代表了这个对象。 - 局部作用域隔离:形参
username仅存在于函数执行时的局部作用域(Local Scope)中。如果在函数外部直接尝试访问print(username),Python 解释器会抛出NameError,因为外界根本看不到函数内部的局部变量。
四、使用 return 语句:获取函数的计算结果
初学者在学习函数时,最容易混淆的概念就是 print() 与 return。两者有着本质的区别:
print()是一个内置函数,作用是将数据格式化后输出到控制台屏幕上供人查看。它并不向程序的后续流程提供数据。return是 Python 语言的控制语句,作用是将函数的计算结果交付给调用方,并立刻终止函数的执行。调用方可以用一个变量将这个返回值接收下来,供后面的代码继续做业务判断或二次计算。
1. 编写带有返回值的函数
新建文件 return_function.py,编写计算矩形面积的函数:
# 定义计算矩形面积的函数,接收两个参数并返回乘积
def calculate_area(width, height):
area = width * height
return area
# 1. 调用函数,并用变量接收返回值
room_area = calculate_area(5, 4)
# 2. 在外部代码中使用该返回值
print(f"房间计算面积为: {room_area} 平方米")
# 3. 对返回值进行二次数学运算
cost = room_area * 120
print(f"装修地砖预计总花费: {cost} 元")
return 语句,或者只写了单个没有携带对象的 return,该函数在执行完毕后会默认返回特殊的空值对象 None。
五、初学者最常遇到的 4 类报错与排查指南
在初次编写函数并尝试调用时,由于语法规则不熟悉,极易触发以下 4 类典型报错。遇到报错时不要慌张,对照下述排查步骤即可快速定位修复。
1. NameError: name 'xxx' is not defined
报错原因:解释器在当前作用域找不到名为 xxx 的函数或变量。最常见的诱因有两个:
- 调用位置在定义之前:Python 是解释型语言,代码自顶向下执行。如果把调用语句
greet()写在def greet():的上方,解释器读到调用时尚未遇到该函数的定义,必然报错。 - 拼写或大小写不一致:Python 严格区分大小写。例如定义了
def send_email():,调用时误写为Send_email()或拼错字母。
修复方法:确保函数的 def 代码块位于调用语句的前面;仔细核对函数名称的每个字母和大小写。
2. SyntaxError: invalid syntax 或 expected ':'
报错原因:代码违反了 Python 的基础标点规则。最常见的是函数头部末尾漏写了英文半角冒号 :,或者在输入法中文状态下输入了全角冒号 :。
修复方法:检查 def 所在行的末尾,确保使用的是英文半角状态下的冒号 :,且圆括号成对闭合。
3. IndentationError: expected an indented block
报错原因:缩进缺失或混乱。在 def 声明下一行,必须缩进至少 1 个空格;如果在编辑器中混用了 Tab 制表符和空格键,解释器也会报错。
修复方法:在函数体内部每一行统一敲击 4 次空格(多数现代编辑器按 Tab 会自动转为 4 空格)。如果函数暂不写具体逻辑,可先用 pass 语句占位,防止出现空缩进块。
4. TypeError: missing / takes 0 positional arguments but 1 was given
报错原因:调用函数时传入的实参数量,与定义时声明的形参数量不一致。
- 若定义为
def show_info(name):,调用时却写成了show_info(),会提示 missing 1 required positional argument。 - 若定义为无参函数
def show_info():,调用时却写了show_info("admin"),会提示 takes 0 positional arguments but 1 was given。
修复方法:回到函数的定义行查看括号内声明了几个参数,确保调用时传入的参数个数完全一致。
六、编写与调用规范总结
编写并调用函数是 Python 模块化编程的基石。在日后的实际项目中,建议随时参考图 4 的全景导图与自查清单,保持代码规范。
| 环节 | 标准语法与规范 | 关键检查项 |
|---|---|---|
| 函数定义 | def 函数名(形参1, 形参2): |
def 小写、蛇形命名法、末尾必须有半角冒号 |
| 函数体实现 | 统一缩进 4 个空格,编写具体业务逻辑 | 严禁 Tab 与空格混用,空函数使用 pass 占位 |
| 结果交付 | 使用 return 结果值 回传数据 |
仅展示用 print,需二次利用必须用 return |
| 函数调用 | 变量 = 函数名(实参1, 实参2) |
必须加小括号、必须在定义之后调用、参数数量严格对应 |
掌握上述规则后,你已经具备了在 Python 中编写各种独立功能模块的能力。下一步可以继续深入学习参数默认值、可变参数(*args, **kwargs)以及函数文档字符串(Docstring)的高级用法。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









