无法安装tableauhyperapi Python模块的问题求助

可能原因及对应解决方案 #

• 检查Python版本兼容性
  Tableau Hyper API仅支持特定范围的Python版本（通常为3.7至3.11），先确认你的Python版本：

  python3 --version
  

  如果版本不在兼容范围内，使用版本管理工具（如pyenv）切换到符合要求的Python版本后再尝试安装。

• 更新pip到最新版本
  老旧版本的pip可能无法识别新的包架构或索引，执行升级命令：

  pip3 install --upgrade pip
  

• 针对M1 macOS的架构适配
  M1芯片为arm64架构，部分包没有预编译的arm64轮子，可尝试两种方式：

  1. 用Rosetta 2运行终端：右键终端→显示简介→勾选「使用Rosetta打开」，重新打开终端后执行安装命令。
  2. 强制安装x86_64架构的包：

     ARCHFLAGS="-arch x86_64" pip3 install tableauhyperapi
     

• 针对Ubuntu 18.04的依赖与版本调整

  1. 安装必要系统依赖：

     sudo apt-get update && sudo apt-get install libssl-dev libcurl4-openssl-dev
     

  2. Ubuntu 18.04默认Python版本为3.6，而tableauhyperapi不支持该版本，需升级Python到3.7及以上版本后再执行安装。

• 手动下载wheel文件安装
  如果上述方法都无效，直接下载对应系统和Python版本的tableauhyperapi wheel文件，执行本地安装：

  pip3 install /path/to/tableauhyperapi-<version>-<platform>.whl
  

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