如何正确安装依赖并运行GitHub仓库的Python脚本

按以下顺序执行操作即可搭建正常运行环境，覆盖解决你遇到的三类报错：

• 进入项目根目录
  拉取项目代码后必须先进入项目根目录，再执行后续所有命令。执行命令前可通过pwd确认当前路径末尾为hoffman_reproduction，避免因路径错误找不到项目配置文件：

  git clone https://github.com/TineKolenik/hoffman_reproduction.git
  cd hoffman_reproduction
  

• 创建独立虚拟环境规避权限与版本冲突
  直接在系统全局环境装包会触发site-packages目录无写入权限、系统自带包版本被覆盖的问题，虚拟环境可完全隔离项目依赖，不影响系统全局配置：

  # 注意：项目依赖适配Python 3.8~3.10版本，版本过高会触发旧版numpy编译失败
  python3 -m venv venv
  # Mac/Linux系统执行该命令激活虚拟环境
  source venv/bin/activate
  # Windows系统执行该命令激活虚拟环境
  # venv\Scripts\activate
  

  激活成功后命令行开头会显示(venv)标识，后续所有pip、python命令都在虚拟环境内执行。
• 升级基础安装工具解决numpy安装异常
  旧版本pip会直接调用setup.py install执行源码编译，是numpy安装进程异常退出的核心原因，先升级相关工具：

  pip install --upgrade pip setuptools wheel
  

• 安装项目依赖

  pip install -r requirements.txt
  

  若仍触发numpy安装报错，先单独执行pip install numpy==1.22.4完成numpy安装，再重新执行上述依赖安装命令即可。
• 运行项目

  python main.py
  

已出现报错的根因说明 #

• numpy安装故障：全局环境下旧版numpy卸载存在进程占用/权限问题，叠加旧版pip默认走源码编译流程、无预编译包支持，导致安装进程退出码为1。
• pip3 install .执行失败：一方面全局环境无写入权限触发安装模式切换，另一方面执行命令时未处于项目根目录，无法识别项目配置文件。
• 运行脚本提示缺少matplotlib：依赖未完成全量安装，激活虚拟环境后重新执行依赖安装命令即可修复。

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