使用Python-Fire直接执行CLI工具时无法识别新增参数

为啥直接跑main.py会报错？ #

核心是两种运行方式的环境存在差异，导致加载的cli.py不是最新版本：

• 虚拟环境不匹配：poetry run edgar-tool用的是项目专属虚拟环境，加载的是你刚修改完的cli.py；但直接执行python main.py可能调用了系统全局Python或其他虚拟环境，里面的cli模块还是未添加group参数的旧版本——哪怕清除了__pycache__，只要其他环境里有同名旧模块就会触发问题。
• 导入路径优先级坑：直接运行main.py时，Python的模块搜索顺序可能优先找到了其他位置的cli.py，而非当前项目目录下的最新文件。
• 相对导入失效：如果main.py里使用了from .cli import SearchFunction这类相对导入，将main.py作为脚本直接执行时，Python会把它当作顶层模块，相对导入逻辑失效，可能导致导入错误或加载旧模块。

怎么搞定？ #

1. 激活项目虚拟环境后再运行 #

用poetry的虚拟环境执行main.py，和poetry run保持环境一致：

# 激活虚拟环境（Windows/Linux/macOS通用）
poetry shell
# 执行脚本
python main.py

这样能确保加载到最新的cli.py。

2. 强制Python优先加载本地模块 #

在main.py开头添加代码，将项目根目录加入模块搜索路径最前端，确保优先读取本地的cli.py：

import sys
from pathlib import Path

# 将当前脚本所在目录（项目根目录）插入到搜索路径最前面
sys.path.insert(0, str(Path(__file__).parent))

from cli import SearchFunction
import fire

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

3. 把相对导入改为绝对导入 #

如果main.py原本用的是from .cli import ...这类相对导入，直接替换为from cli import SearchFunction——配合上面的路径设置，不会再找错模块。

4. 检查并删除残留旧模块 #

先确认当前Python加载的cli模块路径：

python -c "import cli; print(cli.__file__)"

如果输出的路径不是当前项目的cli.py，直接删除该旧文件/文件夹即可。

5. 先验证再运行 #

确认导入的是最新模块：

python -c "import inspect; from cli import SearchFunction; print(inspect.signature(SearchFunction.text_search))"

如果输出包含新增的group参数，再执行python main.py就能正常使用--group参数了。

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