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

求助:无法通过pip安装Python库tiktoken,提示缺少Rust编译器

安装tiktoken时Rust相关报错的解决办法

尝试运行调用tiktoken的Python代码,执行pip install tiktoken安装库时失败,报错提示找不到Rust编译器,以下是报错详情:

正在收集tiktoken
  使用缓存的tiktoken-0.3.3.tar.gz (25 kB)
  安装构建依赖项... 完成
  获取构建wheel的需求... 完成
  准备元数据(pyproject.toml)... 完成
已满足依赖:requests>=2.26.0 (来自tiktoken),位于g:\program files\python\lib\site-packages (版本2.28.2)
正在收集regex>=2022.1.18
  使用缓存的regex-2023.3.23-cp38-cp38-win32.whl (256 kB)
已满足依赖:idna<4,>=2.5 (来自requests>=2.26.0->tiktoken),位于g:\program files\python\lib\site-packages (版本2.9)
已满足依赖:certifi>=2017.4.17 (来自requests>=2.26.0->tiktoken),位于g:\program files\python\lib\site-packages (版本2020.4.5.1)
已满足依赖:charset-normalizer<4,>=2 (来自requests>=2.26.0->tiktoken),位于g:\program files\python\lib\site-packages (版本3.1.0)
已满足依赖:urllib3<1.27,>=1.21.1 (来自requests>=2.26.0->tiktoken),位于g:\program files\python\lib\site-packages (版本1.26.15)
为收集到的包构建wheel:tiktoken
  为tiktoken构建wheel(pyproject.toml)... 错误
  错误:子进程退出时出错

  × 为tiktoken构建wheel(pyproject.toml)未成功运行。
  │ 退出码:1
  ╰─> [37行输出]
      运行bdist_wheel
      运行build
      运行build_py
      创建build
      创建build\lib.win32-cpython-38
      创建build\lib.win32-cpython-38\tiktoken
      复制tiktoken\core.py -> build\lib.win32-cpython-38\tiktoken
      复制tiktoken\load.py -> build\lib.win32-cpython-38\tiktoken
      复制tiktoken\model.py -> build\lib.win32-cpython-38\tiktoken
      复制tiktoken\registry.py -> build\lib.win32-cpython-38\tiktoken
      复制tiktoken\__init__.py -> build\lib.win32-cpython-38\tiktoken
      创建build\lib.win32-cpython-38\tiktoken_ext
      复制tiktoken_ext\openai_public.py -> build\lib.win32-cpython-38\tiktoken_ext
      运行egg_info
      写入tiktoken.egg-info\PKG-INFO
      写入依赖链接到tiktoken.egg-info\dependency_links.txt
      写入依赖要求到tiktoken.egg-info\requires.txt
      写入顶级名称到tiktoken.egg-info\top_level.txt
      读取清单文件'tiktoken.egg-info\SOURCES.txt'
      读取清单模板'MANIFEST.in'
      警告:未找到匹配'Makefile'的文件
      添加许可证文件'LICENSE'
      写入清单文件'tiktoken.egg-info\SOURCES.txt'
      复制tiktoken\py.typed -> build\lib.win32-cpython-38\tiktoken
      运行build_ext
      运行build_rust
      错误:找不到Rust编译器
      
      如果你使用的是过时的pip版本,可能该包有预构建的wheel,但pip无法识别安装。安装预构建wheel可以无需Rust编译器。
     
      要升级pip,请运行:
     
          pip install --upgrade pip
     
      然后重试安装包。
     
      如果你确实打算从源码构建该包,请尝试通过系统包管理器安装Rust编译器,并确保它在安装期间处于PATH中。或者,rustup是下载和更新Rust编译器工具链的推荐方式。
      [输出结束]

  注意:此错误源自子进程,可能与pip无关。
  错误:为tiktoken构建wheel失败
为tiktoken构建wheel失败
错误:无法为tiktoken构建wheel,这是安装基于pyproject.toml的项目所必需的

解决步骤

  • 优先尝试升级pip:旧版pip可能无法识别预编译的wheel包,导致需要从源码编译(依赖Rust)。执行以下命令升级pip:
    pip install --upgrade pip
    
    升级完成后重新运行pip install tiktoken。
  • 如果升级pip后仍失败,安装Rust工具链:
    1. 安装Rust工具链(推荐使用rustup),安装完成后确保Rust编译器已添加到系统PATH中。
    2. 重启终端,重新执行pip install tiktoken。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.25 05:47:48