调用Fire运行返回DataFrame的脚本为何显示文档且无法正常结束？

复现代码 #

import pandas as pd
import fire

def nada():
    data = {
      "calories": [420, 380, 390],
      "duration": [50, 40, 45]
    }
    # 加载数据到DataFrame对象
    df = pd.DataFrame(data)
    return df

if __name__ == "__main__":
    fire.Fire(nada)

现象描述 #

执行python something.py（需提前安装Jinja2）时，脚本未正常结束，反而输出了pandas DataFrame的结构化文档内容（包含NAME、SYNOPSIS、DESCRIPTION、GROUPS等模块），必须输入q才能退出脚本运行，且该现象由return df语句直接导致。

原因解析 #

• Fire的核心机制：自动解析返回对象
  Fire的设计逻辑是，当用它调用函数并返回一个对象时，不会直接输出对象的常规内容，而是将该对象视为可交互的命令行接口实体。它会遍历对象的所有属性、方法，自动生成对应的文档，然后进入交互式浏览模式。

• DataFrame的属性触发文档生成
  pandas的DataFrame自带大量内置属性（如T、at、columns、dtypes等）和方法，Fire会自动收集这些属性的文档字符串（docstring），整理成你看到的结构化文档内容。

• 交互式浏览模式导致阻塞
  Fire生成文档后，会启动依赖Jinja2渲染的分页交互模式，该模式会等待用户输入q来退出，因此脚本不会自动结束，必须手动输入才能终止运行。

解决思路 #

如果希望脚本正常输出DataFrame内容并自动结束，不要直接返回DataFrame对象，而是改为打印内容或返回字符串形式：

def nada():
    data = {
      "calories": [420, 380, 390],
      "duration": [50, 40, 45]
    }
    df = pd.DataFrame(data)
    print(df)  # 直接打印而非返回对象
    # 或者 return str(df)

if __name__ == "__main__":
    fire.Fire(nada)

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