运行Transformers导入代码时遇AttributeError：huggingface_hub.constants无HF_HUB_CACHE属性

具体排查与修复步骤 #

• 启用隔离虚拟环境，避免全局包依赖冲突：

  # 创建venv虚拟环境
  python -m venv transformer_env
  # Windows系统激活环境
  transformer_env\Scripts\activate
  # Linux/macOS系统激活环境
  source transformer_env/bin/activate
  

• 彻底清理并重装依赖包，消除缓存或损坏文件影响：

  # 卸载所有相关包
  pip uninstall -y transformers huggingface_hub datasets accelerate torch
  # 清理pip缓存
  pip cache purge
  # 强制重新安装稳定兼容版本
  pip install torch==2.1.2 transformers==4.35.2 huggingface_hub==0.19.4 datasets==2.14.6 accelerate==0.24.1
  

• 分步验证导入，定位具体报错模块：
  先单独验证PyTorch是否正常工作：

  import torch
  print(f"PyTorch版本: {torch.__version__}")
  

  再验证Transformers核心模块：

  from transformers import __version__, AutoTokenizer
  print(f"Transformers版本: {__version__}")
  

• 检查环境兼容性：确保使用64位Python（3.8-3.11版本最佳），Transformers不支持32位Python环境；同时确认系统架构（x86_64/ARM）与安装的包版本匹配

离线环境额外处理 #

如果在无网络环境下安装，需提前下载对应系统、Python版本的whl包，手动执行安装，避免包损坏或版本不匹配

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