安装coqui.AI TTS API时遭遇metadata-generation-failed错误求助

问题原因 #

你遇到的错误源于docopt==0.6.2的安装脚本存在缺陷：它的setup.py试图从尚未安装的docopt模块导入版本号，而pip默认的构建隔离机制会在独立环境中处理包的元数据生成，导致找不到该模块，最终触发metadata-generation-failed错误。

解决方案 #

针对你的Windows 11 + Spyder环境，可通过以下两种方法解决：

方法1：先手动安装docopt，再安装Coqui TTS #

在Spyder的终端（或IPython控制台中以!开头执行命令）运行：

pip install docopt
pip install TTS

方法2：禁用pip的构建隔离机制直接安装 #

如果方法1无效，可跳过pip的构建隔离，让构建过程使用当前环境已有的依赖：

pip install TTS --no-build-isolation

额外注意事项 #

• 确认Spyder使用的Python环境是你打算安装TTS的环境，可通过以下命令验证：

  !python --version
  !pip --version
  

• 若安装后仍有问题，可尝试升级pip及相关工具到最新版本：

  pip install --upgrade pip setuptools wheel
  

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