如何避免Python中print/字符串格式化错误引发的程序终止？

针对长运行程序因f-string、格式化字符串的低级错误（如变量名拼写错）导致中途终止的问题，以下是几种无需逐个加try-except的可行方案：

方案1：延迟求值的安全打印/日志函数 #

因为f-string会在代码执行到该行时立即解析，直接包装print或logger无法捕获其异常。可以通过传递lambda表达式延迟f-string的生成，在函数内部统一捕获异常：

def safe_print(msg_provider):
    try:
        print(msg_provider())
    except (NameError, KeyError, IndexError) as e:
        print(f"[打印错误] 格式化失败: {str(e)}")

# 调用示例：把f-string放在lambda里
current_value = 100
safe_print(lambda: f"当前计算值为{current_value}")
# 即使变量名写错（比如current_valu），也只会打印错误信息，不会终止程序

如果用logging模块，同理实现safe_log：

import logging

logger = logging.getLogger(__name__)
logger.setLevel(logging.INFO)

def safe_log(level, msg_provider):
    try:
        msg = msg_provider()
        logger.log(level, msg)
    except (NameError, KeyError, IndexError) as e:
        logger.error(f"[日志格式化错误] {str(e)}")

# 调用示例
safe_log(logging.INFO, lambda: f"步骤完成，结果是{result_var}")

方案2：使用非即时解析的格式化方式+包装函数 #

放弃f-string，改用str.format()或%格式化，这类方式的格式化操作在函数内部执行，可直接捕获异常：

def safe_print(fmt, *args, **kwargs):
    try:
        formatted = fmt.format(*args, **kwargs)
        print(formatted)
    except (KeyError, IndexError, ValueError) as e:
        print(f"[打印错误] 原始模板: {fmt}, 错误原因: {str(e)}")

# 调用示例
safe_print("当前值是{}，状态是{status}", 200, status="success")
# 若模板里的占位符写错（比如{statue}），会被捕获

方案3：自定义logging格式化器（仅针对logging模块） #

如果项目主要用logging记录日志，可以自定义一个安全格式化器，全局捕获日志格式化时的异常：

import logging

class SafeFormatter(logging.Formatter):
    def format(self, record):
        try:
            # 尝试正常格式化
            return super().format(record)
        except (KeyError, IndexError) as e:
            # 格式化失败时返回错误提示+原始信息
            return f"[日志格式化失败] 消息模板: {record.msg}, 参数: {record.args}, 错误: {str(e)}"

# 配置logging使用自定义格式化器
handler = logging.StreamHandler()
handler.setFormatter(SafeFormatter("%(asctime)s - %(levelname)s - %(message)s"))
logger = logging.getLogger()
logger.addHandler(handler)
logger.setLevel(logging.INFO)

# 调用示例（需使用占位符而非f-string）
logger.info("任务进度：%(progress)s%%", {"progress": 50})
# 若占位符拼写错误（比如%(progres)s），会返回错误提示而非抛出异常

注意：此方案仅对使用logger.info("模板", args)的方式有效，若直接传入f-string（logger.info(f"进度{progress}")），异常仍会在调用前触发，需结合方案1的延迟求值方式。

方案4：静态检查工具提前规避错误 #

使用mypy、pyright等静态类型检查工具，在编写代码阶段就检测出f-string中的未定义变量、拼写错误等问题，从源头减少这类低级错误。比如在VS Code中配置pyright，当你写出f"{wrong_var}"时，编辑器会立即提示变量未定义，无需等到运行时才发现。

各方案对比 #

• 方案1：兼容f-string写法，只需少量修改调用方式，适合习惯用f-string的场景。
• 方案2：写法稍繁琐，但无需额外的lambda包装，适合对代码简洁度要求不高的场景。
• 方案3：全局生效，无需修改日志调用代码（但仅限占位符式的日志），适合已有大量logging代码的项目。
• 方案4：事前预防，减少运行时错误，但无法处理动态生成的变量名等静态检查无法覆盖的场景，建议与运行时兜底方案结合使用。

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