Kaggle 中解决 pip 依赖冲突的正确方法：使用 legacy 解析器

2026-01-21 00:00:00 作者：花韻仙語

在 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 当前环境（截至 2025 年稳定版）中仍最可靠；
避免全局升级 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__}")