使用pip安装Voice-Cloning库遇encoder模块缺失错误求助

问题分析 #

报错ModuleNotFoundError: No module named 'encoder'是因为Voice-Cloning依赖的encoder模块并非PyPI上的独立包，而是属于关联项目的子模块，pip自动安装时未包含该模块；同时Apple Silicon的arm64架构可能加剧依赖安装的兼容性问题。

解决步骤 #

1. 补充安装依赖的encoder模块 #

• 获取包含encoder模块的Real-Time-Voice-Cloning项目源码，进入项目目录后安装其全部依赖：

  pip install -r requirements.txt
  

• 两种方式让Python识别到encoder模块：
  • 方式一：将项目中的encoder文件夹复制到你的Python环境的site-packages目录下（可通过python -c "import site; print(site.getsitepackages())"查看该路径）。
  • 方式二：在导入Voice-Cloning模块前，先将项目路径添加到Python的搜索路径：

    import sys
    sys.path.append("/你的Real-Time-Voice-Cloning项目本地路径")
    from voice_cloning.generation import *
    

2. 适配Apple Silicon架构 #

• 若使用原生arm64 Python出现兼容性问题，尝试通过Rosetta 2运行终端（右键终端→显示简介→勾选“使用Rosetta打开”），重新创建Python 3.8/3.9虚拟环境并安装：

  # 创建虚拟环境
  python3.8 -m venv voice-clone-env
  source voice-clone-env/bin/activate
  # 重新安装Voice-Cloning及关联依赖
  pip install Voice-Cloning
  pip install -r requirements.txt  # 这里的requirements.txt指Real-Time-Voice-Cloning项目中的依赖文件
  

3. 验证安装 #

• 执行以下代码确认encoder模块可正常导入：

  import encoder.inference as encoder
  

  若无报错，再尝试导入Voice-Cloning的模块即可。

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