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

Windows下pip安装transformers提示找不到Rust编译器求助

问题描述

在Windows系统执行pip install transformers时触发以下报错:

error: can't find Rust compiler

完整报错信息:

If you are using an outdated pip version, it is possible a prebuilt wheel is available for this package but pip is not able to install from it. Installing from the wheel would avoid the need for a Rust compiler.

To update pip, run:

  pip install --upgrade pip

and then retry package installation.

If you did intend to build this package from source, try installing a Rust compiler from your system package manager and ensure it is on the PATH during installation. Alternatively, rustup (available at https://rustup.rs) is the recommended way to download and update the Rust compiler toolchain.
[end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for tokenizers
Failed to build tokenizers
ERROR: Could not build wheels for tokenizers, which is required to install pyproject.toml-based projects

已尝试的操作:

git clone https://github.com/huggingface/transformers.git 
cd transformers
pip install -e .

即使安装了Rust编译器,问题仍未解决。


解决方案

1. 全面更新pip、setuptools和wheel

旧版本的工具链可能无法识别预编译轮子,执行命令更新所有依赖工具:

python -m pip install --upgrade pip setuptools wheel

更新完成后重新尝试pip install transformers。

2. 确认Rust环境已正确配置并生效

安装Rust后,必须重启所有终端和开发工具(如VS Code、PyCharm),环境变量PATH的更新需要重启才能生效。

验证Rust是否可用:

rustc --version

若无法输出版本号,手动添加Rust的bin目录到系统PATH:

  • Rust默认安装路径为C:\Users\<你的用户名>\.cargo\bin
  • 打开系统环境变量设置,将上述路径添加到PATH变量中,保存后重启终端。

3. 手动安装预编译的tokenizers轮子

报错核心是tokenizers需要编译,直接下载匹配你Python版本(如3.10、3.11)和Windows架构(win_amd64)的预编译wheel文件,手动安装后再部署transformers:

# 示例命令,需替换为对应版本的wheel文件名
pip install tokenizers-0.15.1-cp311-none-win_amd64.whl

安装完成后执行pip install transformers。

4. 使用conda安装(推荐有conda环境的用户)

conda仓库中的transformers包已预编译,无需Rust环境:

conda install -c huggingface transformers

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.05 15:55:13