func1 不是 python 内置或标准库函数，而是可能的自定义函数或拼写错误；\_func1 是约定内部使用的私有函数，不建议外部调用，使用时需注意参数传递陷阱和返回值类型。
Func1 函数名在 Python 中并不存在，需确认是否为自定义函数或拼写错误
Python 标准库和内置函数中没有名为 Func1 的函数。如果你在文档、示例或报错信息里看到它，大概率是他人代码中定义的自定义函数，或是误将某个具体函数（如 func1、_func1）记作大驼峰形式。直接调用 Func1() 会触发 NameError: name 'Func1' is not defined。
- 检查所在项目源码，搜索
def Func1(或def func1( - 注意大小写：Python 区分
func1和Func1 - 若来自第三方库，查该库的 API 文档，确认函数真实名称和模块路径（例如是否应为
some_module.func1()）
_func1 开头的函数是约定俗成的“内部使用”函数
以下划线开头（如 _func1）是 Python 的命名惯例，表示该函数不建议外部直接调用——它可能是模块内部辅助逻辑，接口不稳定，未来可能删改或重命名。
- 即便能成功调用
_func1()，也不代表它是公开 API；IDE 通常会标灰或给出警告 - 如果必须用，先确认其所在模块已导入：
from mymodule import _func1
或import mymodule; mymodule._func1()
- 查看函数定义处的 docstring（如果有），重点关注参数类型说明和返回值描述，因为这类函数往往不做运行时类型校验
_func1 的参数传递常见陷阱
自定义函数的参数行为完全由其实现决定，但实践中几个高频问题值得警惕：
- 参数是传值还是传引用？对可变对象（如
list、dict）做原地修改，会影响调用方变量 - 是否接受
*args或**kwargs？漏传关键字参数可能被静默吞掉，或抛出TypeError - 是否有默认参数且值为可变对象？例如
def _func1(items=[]):—— 这会导致多次调用间状态残留 - 是否依赖全局变量或闭包环境？脱离原始模块上下文后可能报
NameError或返回意外结果
返回值处理要匹配实际类型，别假设它是 dict 或 str
_func1 的返回值类型必须以其实现为准。常见误操作包括：
立即学习“Python免费学习笔记（深入）”；
- 直接链式调用
_func1().keys()，但函数实际返回None或int，导致AttributeError - 用
json.dumps(_func1())序列化，但返回值含不可序列化对象（如datetime、自定义类实例） - 用
if _func1():做真值判断，却没意识到空列表[]或数字0会被判为 False，而业务上它们可能是有效结果 - 未处理异常返回：有些
_func1在失败时返回特殊标记值（如-1、None），而非抛异常，需主动检查
最稳妥的方式是先打印类型：
result = _func1(x, y)<br>print(type(result), result)
函数边界模糊的地方，永远比文档更诚实。
