如何实现Python代码中tqdm的可选无缝调用？

直接在导入阶段处理异常，同时定义一个与tqdm接口兼容的空包装函数，确保后续代码无需任何适配即可无缝运行：

核心实现代码 #

try:
    from tqdm import tqdm
except ImportError:
    # 定义与tqdm参数兼容的空包装器，直接返回原迭代对象
    def tqdm(iterable, *args, **kwargs):
        return iterable

使用示例 #

后续业务代码完全不需要修改，直接像正常使用tqdm一样调用即可：

# 不管tqdm是否安装，这段代码都能正常运行
for item in tqdm(range(10000)):
    # 执行你的业务逻辑
    pass

方案优势 #

• 一次性在导入阶段处理兼容逻辑，后续代码无感知
• 彻底避免NameError和ImportError
• 不需要额外文件或复杂函数封装，代码极简
• 空包装器兼容tqdm的所有参数（比如desc、total等），即使传入也不会报错，只是不生效

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