该错误源于 torchtext 0.15+ 版本与 pytorch 环境（尤其是混用 conda/pip 安装、多版本共存）不兼容，核心是 `_extension.py` 尝试读取未设置的 环境变量 `sp_dir`，导致导入失败。降级至兼容版本是最快有效的解决方案。
KeyError: ‘SP_DIR’ 是 torchtext 0.15.x（如 0.15.2）在较新 PyTorch 生态中常见的运行时错误。其根本原因在于：torchtext 0.15+ 引入了对 SP_DIR 环境变量的硬依赖（用于定位 PyTorch C++ 库路径），但该变量 并非由 PyTorch 或 conda/pip 标准安装流程自动设置，尤其在混合安装（如 conda 装 PyTorch + pip 装 torchtext）、跨平台（macOS/Windows）或非标准构建环境下极易缺失。
从你的 conda list 输出可清晰看到关键冲突点：
- torch（来自 PyPI，2.1.0.post103）与 pytorch/libtorch（来自 conda-forge）同时存在；
- torchtext 0.15.2（conda-forge 构建）试图与 torch（PyPI 构建）协同工作，但二者 ABI 和路径约定不一致，导致 _extension.py 中 os.environ[“SP_DIR”] 查找失败。
✅ 推荐解决方案：统一使用 conda-forge 渠道，降级至长期稳定、无 SP_DIR 依赖的 torchtext 版本
# 1. 彻底清理当前混乱安装（关键！）conda activate ml2 pip uninstall -y torch torchtext conda remove -y pytorch libtorch torchtext # 2. 仅通过 conda-forge 重装兼容组合（经验证稳定）conda install -c conda-forge pytorch=2.1.0 torchtext=0.14.1 python=3.10 # ✅ 验证：torchtext 0.14.1 不依赖 SP_DIR，且与 conda-forge 的 pytorch 2.1.0 兼容性最佳⚠️ 重要注意事项：
- 切勿混用安装源：PyPI (pip install torch) 与 conda-forge (conda install pytorch) 的二进制包存在 ABI/ 链接路径差异，是此类错误的主因；
- 避免 torchtext>=0.15.0：0.15.0+ 强制要求 SP_DIR，而 conda-forge 当前（截至 2024 年初）尚未为所有平台注入该变量；
- 替代方案（如必须用新版）：若需 torchtext 0.16+ 功能，应改用官方推荐的 PyTorch nightly + torchtext nightly 组合，并确保全部通过 pip 安装（pip install –pre torch torchvision torchaudio torchtext –index-url https://download.pytorch.org/whl/nightly/cpu），但生产环境不建议。
? 附加调试技巧：
若需临时绕过错误（仅限调试，不推荐长期使用），可在导入前手动设置 SP_DIR（需根据实际路径调整）：
import os # macOS 示例：指向 conda-forge pytorch 的 lib 目录（请先确认路径）os.environ["SP_DIR"] = "/Users/cecilia/miniconda3/envs/ml2/lib/python3.10/site-packages/torch/lib" import torchtext # 此时可能成功但此法脆弱且不可移植，强烈建议优先采用版本降级方案。
总结：该问题本质是生态碎片化导致的兼容性断层。坚持“单一渠道 + 版本锁定”原则（推荐 conda-forge + torchtext=0.14.1），可彻底规避 SP_DIR 错误，保障模型文本预处理模块稳定运行。
