
在 kaggle notebook 中执行 `pip install` 时,新版 pip 的严格依赖解析器常与预装环境(如 tensorflow 2.6.3、numpy 1.21.6)发生冲突;推荐临时降级至兼容性更强的 `--use-deprecated=legacy-resolver` 模式安装包。
Kaggle 的 Python 环境是预配置的(含特定版本的 tensorflow、numpy、absl-py 等),而新版 pip(≥20.3)默认启用的 backtracking dependency resolver 会强制尝试满足所有包的精确版本约束,导致与已安装包不兼容时直接报错(如 tensorflow 2.6.3 requires numpy~=1.19.2,但系统已装 1.21.6)。这不是你代码的问题,而是 pip 解析策略与 Kaggle 只读基础环境之间的设计冲突。
✅ 推荐解决方案:显式启用旧版解析器
在安装命令中添加 --use-deprecated=legacy-resolver 参数,绕过严格的回溯检查,恢复 pip 20.2 之前的“先到先得”行为(即尊重已安装版本,仅升级/降级显式指定的包):
!pip install -Uqq fastai duckduckgo_search --use-deprecated=legacy-resolver
⚠️ 注意事项:
- 该参数是 临时兼容方案,官方已标记为 deprecated(未来 pip 版本将移除),但在 Kaggle 当前环境(截至 2024 年稳定版)中仍最可靠;
- 避免全局升级 pip(如 !pip install -U pip),Kaggle 内置 pip 版本经过适配,手动升级反而可能加剧解析异常;
- 若需多包安装,务必一次性声明全部依赖(如上例同时指定 fastai 和 duckduckgo_search),分多次调用 pip install 可能因中间状态引发新冲突;
- 安装后建议验证关键依赖是否可用:
import fastai print(fastai.__version__) # 确认无 ImportError
? 进阶提示:对于长期维护的 Notebook,可考虑在开头统一处理依赖:
# 兼容性优先:一次安装所需库,禁用新解析器
!pip install -Uqq "fastai>=2.7" "torchvision>=0.13" --use-deprecated=legacy-resolver
import torch, fastai
print(f"PyTorch {torch.__version__} | fastai {fastai.__version__}")总之,在 Kaggle 中不必追求“完美依赖图”,而应以环境稳定性为第一目标——--use-deprecated=legacy-resolver 正是平衡兼容性与功能性的务实选择。










