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 的返回值类型必须以其实现为准。常见误操作包括：

• 直接链式调用 _func1().keys()，但函数实际返回 None 或 int，导致 AttributeError
• 用 json.dumps(_func1()) 序列化，但返回值含不可序列化对象（如 datetime、自定义类实例）
• 用 if _func1(): 做真值判断，却没意识到空列表 [] 或数字 0 会被判为 False，而业务上它们可能是有效结果
• 未处理异常返回：有些 _func1 在失败时返回特殊标记值（如 -1、None），而非抛异常，需主动检查

最稳妥的方式是先打印类型：

result = _func1(x, y)
print(type(result), result)

函数边界模糊的地方，永远比文档更诚实。