旧版pip与setuptools环境下Python包依赖配置及安装指引优化

一、推荐安装流程（分两步是可靠且最优的方式） #

直接用pip install -r requirements.txt失效的核心原因是：高版本pip会自动更新自身，覆盖你指定的pip==21.0，导致后续安装旧版gym、pyglet时使用的是更新后的pip，兼容性逻辑不匹配引发失败。分两步操作是目前最稳妥的方案，具体步骤如下：

1. 创建并激活虚拟环境（必须推荐，避免污染全局包环境）

python -m venv gym-env
# Linux/macOS激活命令
source gym-env/bin/activate
# Windows激活命令
gym-env\Scripts\activate

2. 先锁定pip和setuptools版本

pip install pip==21.0 setuptools==65.5.0

3. 安装项目依赖
   将核心依赖写入requirements.txt：

gym==0.21.0
pyglet==1.5.27

然后执行安装：

pip install -r requirements.txt
# 若需以可编辑模式安装项目本身，替换为：
# pip install -e .

二、可选优化：一键安装脚本 #

为简化用户操作，可以写一个脚本整合所有步骤：

• Linux/macOS 脚本（命名为install.sh）：

#!/bin/bash
python -m venv gym-env
source gym-env/bin/activate
pip install pip==21.0 setuptools==65.5.0
pip install -r requirements.txt
echo "环境安装完成，执行 'source gym-env/bin/activate' 激活环境即可使用"

• Windows 脚本（命名为install.bat）：

python -m venv gym-env
call gym-env\Scripts\activate
pip install pip==21.0 setuptools==65.5.0
pip install -r requirements.txt
echo 环境安装完成，执行 'gym-env\Scripts\activate' 激活环境即可使用
pause

三、README文档的规范写法 #

要把依赖限制和安装步骤写得清晰直白，示例如下：

安装步骤 #

1. 创建独立虚拟环境
   避免与全局Python包冲突，执行：

   python -m venv gym-env
   

2. 激活虚拟环境
   • Linux/macOS：source gym-env/bin/activate
   • Windows：gym-env\Scripts\activate
3. 安装指定版本的包管理工具
   由于依赖旧版Gym，必须先锁定工具版本：

   pip install pip==21.0 setuptools==65.5.0
   

4. 安装项目依赖

   pip install -r requirements.txt
   # 若需修改项目代码后实时生效，执行：
   # pip install -e .
   

依赖说明 #

本项目依赖旧版OpenAI Gym生态，具体版本要求：

• gym==0.21.0
• pyglet==1.5.27
  为确保安装成功，必须搭配指定版本的包管理工具：
• pip==21.0
• setuptools==65.5.0

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