如何正确安装DeepSpeech库？解决导入及版本匹配等安装问题

先明确前提 #

DeepSpeech官方已停止维护，最新稳定版为0.9.3，仅支持Python 3.6-3.8，不同操作系统需对应匹配的预编译包，这是很多安装问题的核心原因。

1. 解决「指定安装0.9.3版本提示找不到匹配版本」的问题 #

直接用pip install deepspeech==0.9.3失败，大概率是Python版本不兼容或PyPI镜像未同步预编译包，按以下方式处理：

• 先确认当前Python版本：运行python --version，如果版本不在3.6-3.8范围内，用虚拟环境创建对应版本环境（比如python3.7 -m venv ds-env，激活后再安装）。
• 强制使用预编译二进制包安装：

  pip install deepspeech==0.9.3 --only-binary :all:
  

• 若仍失败，手动下载对应系统的.whl文件本地安装：
  找到对应Python版本和系统的轮子包（比如Python3.7+Windows64位对应deepspeech-0.9.3-cp37-cp37m-win_amd64.whl），运行：

  pip install /本地路径/deepspeech-0.9.3-xxx.whl
  

2. 解决「导入deepspeech时出现ModuleNotFoundError」的问题 #

• 检查是否在安装DeepSpeech的虚拟环境中运行代码：激活虚拟环境后，用pip list确认deepspeech已出现在列表中。
• 若之前尝试过源码安装，先卸载旧版本：pip uninstall -y deepspeech，再重新用预编译包安装。

3. 解决「GitHub目录安装时出现metadata-generation-failed错误」的问题 #

源码安装依赖链复杂，需满足多个前置条件：

• 安装指定版本的依赖：

  pip install tensorflow==2.3.0 numpy==1.19.5
  

• 安装SWIG工具：
  • Linux：apt-get install swig（Debian/Ubuntu）
  • macOS：brew install swig
  • Windows：下载SWIG并添加到系统PATH
• 切换到0.9.3版本分支后安装：

  git clone https://github.com/mozilla/DeepSpeech.git
  cd DeepSpeech
  git checkout tags/v0.9.3
  pip install .
  

注意：源码安装容易出现依赖冲突，优先推荐用预编译包安装，除非你需要自定义修改源码。

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