本地包安装后Python脚本需加标志运行，Airflow命令失效求助

核心问题分析 #

执行python setup.py install安装本地包后，原conda环境被污染：

• 项目内脚本需额外标志才能运行
• Airflow基础命令（如airflow dags list）失效
• 新环境重装Airflow可正常运行，说明原环境的依赖或路径被破坏

分步排查与解决 #

1. 先卸载本地包，验证环境是否恢复 #

先卸载安装的fila-espera-pkg，确认问题是否由本地包安装导致：

pip uninstall fila-espera-pkg -y

卸载后执行airflow dags list，如果恢复正常，直接跳到步骤3重新安装本地包；若仍异常，执行步骤2修复Airflow环境。

2. 修复原环境的Airflow依赖 #

若卸载本地包后Airflow仍异常，说明环境依赖已被篡改：

• 先检查依赖冲突：

pip check

输出的冲突项就是需要优先修复的内容。

• 强制重新安装Airflow（指定你原环境使用的版本）：

pip install --force-reinstall apache-airflow==<你的Airflow版本号>

• 必要时清理pip缓存后再重装：

pip cache purge
pip install apache-airflow==<你的Airflow版本号>

3. 安全重新安装本地包 #

放弃python setup.py install，改用可编辑模式安装，避免污染环境：

cd 你的本地包所在目录
pip install -e .

可编辑模式仅在site-packages中创建本地包的链接，不会覆盖或强制升级环境依赖，同时修改本地包代码可实时生效，更适合开发场景。

4. 修复setup.py的潜在问题 #

你的setup.py存在两个高危点，是导致环境污染的根源：

• 不要全量导入项目根目录的requirements.txt：
  install_requires=reqs会强制安装/升级项目所有依赖，极易与Airflow的依赖版本冲突。建议只在setup.py中声明本地包自身必需的依赖，例如：

  install_requires=[
      "pandas>=1.0",
      "numpy>=1.18"
      # 仅保留本地包运行必须的依赖项
  ]
  

• 简化项目路径获取逻辑：
  多次嵌套resolve().parent容易出现路径错误，建议先打印路径确认正确性：

  project_dir = Path(__file__).parent.parent.parent.parent
  print("项目根目录路径：", project_dir)  # 确认路径正确后再加载文件
  

预防措施 #

• 开发本地包始终使用pip install -e .替代python setup.py install
• 本地包依赖与项目级依赖分开管理，避免在setup.py中全量导入项目requirements
• 定期用pip list对比新环境与原环境的包版本，及时发现依赖冲突

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