运行Tortoise TTS遇'tortoise.api'模块缺失错误的解决方法

• 纠正无效操作：PyPI不存在tortoise.api这个包，执行sudo pip install --upgrade tortoise.api是错误的，先卸载该无效包（若已安装）：

  sudo pip uninstall tortoise.api
  

• 拉取仓库子模块：该仓库的Tortoise TTS代码作为子模块存在，若本地仓库没有tortoise目录（含api.py文件），执行以下命令拉取完整代码：

  git submodule update --init --recursive
  

• 匹配Python版本安装依赖：你使用python3.9，需确保用对应版本的pip安装依赖，避免环境不匹配：

  pip3.9 install -r requirements.txt
  

• 让Python识别内置模块：若脚本仍找不到tortoise.api，可通过两种方式让Python定位到仓库内的模块：

  1. 运行脚本时临时添加仓库根目录到Python路径：

     PYTHONPATH=. python3.9 ./src/main.py "$@"
     

  2. 修改src/main.py，在文件开头添加路径配置：

     import sys
     import os
     sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
     

• 使用虚拟环境隔离依赖（推荐）：避免系统级Python环境冲突，创建并激活专属虚拟环境后再操作：

  1. 创建虚拟环境：

     python3.9 -m venv tortoise-venv
     

  2. 激活虚拟环境：

     source tortoise-venv/bin/activate  # Linux/Mac系统
     # Windows系统执行：tortoise-venv\Scripts\activate
     

  3. 安装依赖并运行脚本：

     pip install -r requirements.txt
     python ./src/main.py "$@"
     

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