MyBinder部署Jupyter交互式Notebook遇numpy模块缺失报错求助

高频出错点 #

• 依赖配置文件命名错误：MyBinder 平台固定识别的根目录依赖文件名为 requirements.txt（复数形式），如果错写为单数的 requirement.txt，平台扫描仓库时会完全忽略该文件，直接使用预装基础环境启动，基础镜像内没有 numpy、pandas 这类第三方库，必然触发模块找不到的报错
• 依赖文件路径错误：MyBinder 仅读取仓库根目录下的环境配置文件，如果把依赖文件放在了子文件夹中，平台无法识别，不会执行任何依赖安装操作
• pip freeze 生成的依赖文件无效：本地直接执行 pip freeze > requirements.txt 导出的内容，会混杂大量本地环境专属的无效包（比如带本地路径的编译包、和notebook运行无关的系统工具、编辑器插件依赖），云端构建时经常会因为这类内容安装失败，平台为了不阻塞用户访问，会直接跳过依赖安装步骤，用无第三方库的基础镜像启动会话
• 提前操作未构建完成的环境：MyBinder 首次启动需要在云端完成依赖安装、环境镜像构建，这个过程通常需要3-5分钟，如果没等页面显示构建完成（进度条消失、出现环境就绪提示）就跳转到notebook页面，加载的是还未安装依赖的临时环境

可落地的修正步骤 #

• 第一时间核对仓库内的依赖文件：确认文件名完全匹配 requirements.txt，文件在仓库根目录下，没有拼写偏差、没有嵌套路径问题
• 替换全量导出的依赖内容：删掉所有和notebook运行无关的本地专属包，仅保留notebook实际需要的第三方库（比如直接写入 numpy、pandas，需要固定版本时再追加具体版本号），减少构建失败概率
• 重新触发MyBinder构建流程，全程等待环境构建完成，不要中途跳转页面，等环境就绪后再测试库导入
• 排查时调出MyBinder的构建日志，确认日志中存在读取requirements.txt、执行pip安装的对应记录，如果日志中完全没有相关记录，优先回头检查文件名和路径问题

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