Python中func不是内置函数，而是约定俗成的占位符名称，用于示例或高阶函数参数中表示需传入的可调用对象；实际功能由def定义的逻辑决定，命名应语义化。

Python 里没有叫 func 的内置函数，它只是开发者常用来占位的函数名，不代表任何特定功能。 真正起作用的是你用 def 定义的逻辑，而不是名字叫什么。

为什么总看到 func 这个名字

这是约定俗成的“占位符”写法，多出现在示例、文档、高阶函数参数中，表示“这里要传一个函数”。它本身不带行为，也不提供能力。

• 比如 map(func, iterable) 中的 func 只是示意你需要传一个可调用对象
• 写教程时用 def func(x): return x * 2 是为了聚焦语法结构，避免名字干扰理解
• 真实项目里应使用语义化名称，如 calculate_tax、validate_email

自定义函数的正确定义方式

用 def 关键字 + 明确函数名 + 括号参数 + 冒号 + 缩进代码块。是否返回值、是否有默认参数、是否支持变长参数，全由你控制。

• 最简形式：def my_function(): pass
• 带参数和返回值：def add(a, b): return a + b
• 带默认参数：def greet(name, prefix="Hello"): return f"{prefix}, {name}!"
• 接受任意位置参数：def log(*messages): print("LOG:", messages)

func 作为参数传入时的常见错误

新手容易把 func 当作已存在函数直接调用，结果报 NameError: name 'func' is not defined。

def apply_operation(func, x):
    return func(x)
❌ 错误：func 未定义
result = apply_operation(func, 5)
✅ 正确：传一个实际存在的函数（或 lambda）
result = apply_operation(lambda x: x ** 2, 5)
或
def square(x): return x ** 2
result = apply_operation(square, 5)

关键点在于：传进去的必须是已经定义好、可调用的对象，不是字符串名，也不是未声明的变量。

命名建议与易忽略细节

函数名影响可读性与调试效率，但 Python 不强制要求类型提示或文档——而这两点恰恰是团队协作中最容易被跳过的部分。

• 别用 func、f、do_something 这类模糊名称，除非是临时脚本中的单行测试
• 参数多于两个时，考虑用 typing.NamedTuple 或数据类封装，别硬塞一堆位置参数
• 函数体超过 10 行、逻辑分支超过 3 个，大概率该拆了——func 不是藏复杂逻辑的借口
• 如果函数只在某个类内部使用，优先写成私有方法（_helper()），而不是独立的 func

真正难的从来不是写个能跑的 func，而是让别人（包括两周后的你自己）一眼看懂它该做什么、不该做什么、边界在哪。