Python不修改函数原有返回值时如何向调用方传递布尔标记

你遇到的问题核心约束是不能破坏f()的存量调用逻辑，Python有三种完全符合PEP8规范、无不良副作用的实现方案，按推荐优先级排序如下：

方案1：通过可选关键字参数传入可变容器承载标记值 #

这是代码侵入性最小的方案。布尔类型是不可变对象，传入函数后重新赋值不会影响外部变量，但列表、字典这类可变容器传入后，函数内部对容器内容的修改会同步反映到外部。你只需要给这个承载参数设置默认值None，所有存量调用方不需要做任何改动。
示例代码：

def f(flag_out=None):
    result = "hello"
    # f内部计算得到的布尔标记
    calced_flag = True
    # 仅当调用方显式传入承载容器时，才写入标记值
    if flag_out is not None:
        flag_out[0] = calced_flag
    return result

def x():
    # 用单元素列表作为标记值的载体
    flag = [False]
    a = f(flag_out=flag)
    print(a)
    # 读取flag[0]即可拿到f内部计算的布尔值
    print(f"获取到的标记值：{flag[0]}")

补充：如果觉得单元素列表语义不够清晰，也可以用dataclasses定义一个轻量的值承载类，代码可读性会更好，没有额外的兼容成本。

方案2：增加可选返回模式开关，保持默认行为不变 #

给f增加一个仅限关键字传入的开关参数，默认行为和原有逻辑完全一致（仅返回字符串），只有新调用方显式打开开关时，才返回(字符串, 布尔值)的元组，存量调用方完全不受影响。
示例代码：

# 参数列表中的*表示后面的参数必须以关键字形式传入，彻底避免位置传参的兼容风险
def f(*, with_flag=False):
    result = "hello"
    calced_flag = True
    if with_flag:
        return result, calced_flag
    return result

def x():
    # 新调用方显式声明需要拿到标记值
    a, flag = f(with_flag=True)
    print(a)
    print(f"获取到的标记值：{flag}")

# 所有存量调用方不需要做任何修改，行为和之前完全一致
# 比如老代码中写a = f() 依然会正常拿到"hello"，不会返回元组

这个方案的接口语义最清晰，没有隐式的修改行为，是长期维护性最好的方案。

方案3：使用上下文变量（适合多线程/异步并发场景） #

如果代码涉及多线程、异步协程，担心可变容器带来的跨上下文串值问题，可以用Python标准库contextvars提供的上下文变量传递标记值，不同执行上下文的变量完全隔离，线程/协程安全。
示例代码：

from contextvars import ContextVar

# 定义全局上下文变量，设置默认值为False
f_calced_flag = ContextVar("f_calced_flag", default=False)

def f():
    result = "hello"
    calced_flag = True
    # 向当前执行上下文写入标记值
    f_calced_flag.set(calced_flag)
    return result

def x():
    a = f()
    # 从当前上下文读取标记值
    flag = f_calced_flag.get()
    print(a)
    print(f"获取到的标记值：{flag}")

这个方案不需要修改f的参数列表，对f本身的侵入性极低，缺点是需要额外定义上下文变量，简单业务场景下用前两个方案更轻便。

不推荐的做法 #

不要通过给f函数挂载动态属性的方式（比如f.flag = calced_flag）存储标记值，这种本质是全局状态的实现方式，在多线程、递归调用f的场景下会出现值覆盖问题，调试和维护成本极高，属于明确的不良实践。

内容的提问来源于stack exchange，提问作者Itai Bar