You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

安装Huggingface Transformers时safetensors编译失败求助

解决 safetensors 编译失败导致的 transformers 安装错误

你遇到的是安装 transformers 时依赖的 safetensors 编译失败问题,以下是几个可行的解决方向:

  • 安装完整 Rust 工具链
    safetensors 核心用 Rust 编写,仅安装 setuptools_rust 不足以完成编译。直接安装 Rust 官方工具链:

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    

    安装完成后重启终端,或者执行 source $HOME/.cargo/env 加载 Rust 环境,再重新运行 pip install -q transformers。

  • 优先安装预编译的 safetensors 轮子
    如果编译持续失败,可直接使用对应系统和 Python 版本的预编译包。先通过 python --version 确认你的 Python 版本,再去 PyPI 找到匹配的 .whl 文件下载安装,示例命令:

    # 示例:适配 Python3.10 64位 Linux 的版本
    pip install safetensors-0.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
    

    成功安装 safetensors 后,再执行 pip install -q transformers。

  • 关闭构建隔离安装 safetensors
    尝试绕过 pip 的构建隔离机制,让安装过程直接调用系统已有的依赖:

    pip install safetensors --no-build-isolation
    

    完成后再安装 transformers。

  • 补全系统基础编译工具
    部分系统缺少编译所需的基础组件:

    • Ubuntu/Debian:sudo apt-get install build-essential
    • CentOS/RHEL:sudo yum groupinstall "Development Tools"
    • macOS:运行 xcode-select --install 安装 Xcode 命令行工具

内容的提问来源于stack exchange,提问作者eklavyaisabird

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.13 00:44:54