Kaggle旧环境（含已下载文件）导出与新环境导入问题求助

问题根源 #

pip freeze会导出所有已安装包的精确版本，但bq_helper属于扁平布局的非标准Python包，没有遵循PyPI包的元数据规范（比如缺少合规的setup.py或pyproject.toml），导致用pip install -r批量安装时，pip无法正确识别其模块结构，进而触发元数据生成失败的错误。

正确的环境导出与导入步骤 #

一、旧Notebook环境导出 #

1. 过滤非标准包，生成干净的依赖列表
   执行以下命令，排除bq_helper这类有问题的包，只导出PyPI上的标准包：

   pip freeze | grep -v "bq_helper" > kaggle_environment_clean.txt
   

   把生成的kaggle_environment_clean.txt上传到Gist备用。

2. 单独备份非标准包代码
   先定位bq_helper的安装路径：

   import bq_helper
   print(bq_helper.__file__)
   

   找到路径后，把整个bq_helper模块的所有.py文件打包，或者直接复制代码内容，后续在新Notebook中使用。

二、新Notebook环境导入 #

1. 安装标准依赖
   执行命令安装过滤后的标准包：

   pip install -r <你的清理后依赖文件的Gist链接>
   

2. 恢复bq_helper模块
   有两种方式可选：

   • 本地文件导入：把备份的bq_helper模块文件放到新Notebook的/kaggle/working/目录下，然后添加路径到Python环境：

     import sys
     sys.path.append('/kaggle/working/')
     import bq_helper
     

   • 源码安装：如果bq_helper来自GitHub仓库，直接执行源码安装命令：

     pip install git+<对应的GitHub仓库地址>
     

长期稳健方案 #

• 放弃用pip freeze全量导出依赖，改为手动维护requirements.txt，只添加你明确需要的标准PyPI包，版本号可以用宽松约束（比如pandas>=1.3.0），减少版本冲突风险。
• 对于自定义或非标准包，单独记录其来源或备份代码，不要混入标准依赖列表中。

内容的提问来源于stack exchange，提问作者Đỗ Như Vỹ