MacBook环境下无法从PyPI安装tiktoken的问题求助

问题描述 #

在MacBook设备上执行pip3 install tiktoken -v（pip版本22.3.1）时出现报错，核心错误信息如下：

---

Could not find function xmlCheckVersion in library libxml2. Is libxml2 installed?
Perhaps try: xcode-select --install

---

error: command '/usr/bin/clang' failed with exit code 1
...
× Running setup.py install for pycryptodomex did not run successfully.
│ exit code: 1
...
error: legacy-install-failure
× Encountered error while trying to install package.
╰─> pycryptodomex

已尝试升级相关库，但问题仍未解决，寻求可行的解决方法。

解决步骤 #

• 安装Xcode Command Line Tools
  按照报错提示执行命令，安装编译所需的基础工具：

  xcode-select --install
  

  跟随弹窗提示完成安装后，重启终端再尝试安装tiktoken。

• 安装并配置libxml2依赖
  通过Homebrew安装libxml2（未安装Homebrew需先安装）：

  brew install libxml2
  

  配置环境变量让系统识别该库：

  export LDFLAGS="-L/usr/local/opt/libxml2/lib"
  export CPPFLAGS="-I/usr/local/opt/libxml2/include"
  

  配置完成后重新执行tiktoken安装命令。

• 直接安装pycryptodomex预编译包
  绕过源码编译，使用预编译的wheel包安装依赖：

  pip3 install pycryptodomex --only-binary :all:
  

  完成后再执行pip3 install tiktoken。

• 强制更新pip、setuptools和wheel
  重新更新工具链，避免版本兼容问题：

  pip3 install --upgrade pip setuptools wheel
  

  更新后再次尝试安装tiktoken。

• 使用虚拟环境隔离依赖
  若全局环境依赖混乱，创建独立虚拟环境后安装：

  # 创建虚拟环境
  python3 -m venv tiktoken-env
  # 激活虚拟环境
  source tiktoken-env/bin/activate
  # 安装tiktoken
  pip install tiktoken
  

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