安装django-autotranslate遇Preparing metadata(setup.py)错误，求解决

问题现象 #

尝试安装django-autotranslate包（包括新旧版本），均触发Preparing metadata (setup.py) error和error: subprocess-exited-with-error错误，执行pip install django-autotranslate的命令输出如下：

Collecting django-autotranslate
  Using cached django_autotranslate-1.2.0-py3-none-any.whl (10 kB)
Collecting six
  Using cached six-1.16.0-py2.py3-none-any.whl (11 kB)
Collecting goslate
  Using cached goslate-1.5.4.tar.gz (14 kB)
  Preparing metadata (setup.py) ... done
Collecting polib
  Using cached polib-1.1.1-py2.py3-none-any.whl (20 kB)
Requirement already satisfied: django in c:\users\vyktor\dev\language-translator\venv\lib\site-packages (from django-autotranslate) (4.1.2)
Requirement already satisfied: sqlparse>=0.2.2 in c:\users\vyktor\dev\language-translator\venv\lib\site-packages (from django->django-autotranslate) (0.4.3)
Requirement already satisfied: tzdata in c:\users\vyktor\dev\language-translator\venv\lib\site-packages (from django->django-autotranslate) (2022.5)
Requirement already satisfied: asgiref<4,>=3.5.2 in c:\users\vyktor\dev\language-translator\venv\lib\site-packages (from django->django-autotranslate) (3.5.2)
Collecting futures
  Using cached futures-3.0.5.tar.gz (25 kB)
  Preparing metadata (setup.py) ... error
  error: subprocess-exited-with-error

  × python setup.py egg_info did not run successfully.
  │     exit code: 1
  ╰─>   [27 lines of output]

解决步骤 #

错误根源在于futures包仅支持Python2，而当前使用Python3环境，旧版pip会错误尝试安装该依赖。按以下顺序操作：

• 升级pip及相关工具
  执行命令更新pip、setuptools和wheel，确保依赖解析逻辑正确：

  pip install --upgrade pip setuptools wheel
  

• 跳过futures依赖安装django-autotranslate
  直接安装目标包并忽略不必要的依赖，再手动安装所需的兼容依赖：

  # 安装django-autotranslate不自动处理依赖
  pip install django-autotranslate --no-deps
  # 手动安装所需的Python3兼容依赖
  pip install six goslate polib
  

• 验证安装
  执行以下命令确认安装成功：

  pip show django-autotranslate
  

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