克隆GitHub仓库运行Python程序遇ModuleNotFoundError，如何统一管理依赖？

其他用户会不会遇到同样的错误？ #

肯定会。只要你的代码里明确import了cryptography模块，而用户的Python环境里没预先安装这个库，运行时就会抛出ModuleNotFoundError。这是Python第三方依赖的常规问题，不是个别设备的特殊情况。

多个依赖必须逐个安装吗？有没有规避方法？ #

完全不用逐个装，用Python的依赖管理工具就能一次性搞定所有依赖，常用方案如下：

• 生成requirements.txt依赖清单
  在你自己的开发环境里，运行以下命令生成包含所有项目依赖的文件：

  # 方法1：导出当前环境所有包（包含项目未用到的也会导出）
  pip freeze > requirements.txt
  
  # 方法2：只导出项目实际用到的依赖（需先安装pipreqs）
  pip install pipreqs
  pipreqs /path/to/your/project
  

  把生成的requirements.txt提交到GitHub仓库，其他用户克隆后，只需运行一行命令就能安装所有依赖：

  pip install -r requirements.txt
  

• 用虚拟环境隔离依赖（进阶方案）
  为了避免项目依赖污染全局Python环境，建议用虚拟环境管理：

  # 创建虚拟环境（venv是Python3.3+自带的）
  python -m venv venv
  
  # 激活虚拟环境：
  # Windows系统
  venv\Scripts\activate
  # Linux/macOS系统
  source venv/bin/activate
  
  # 在激活的虚拟环境里安装项目依赖，再生成requirements.txt
  

  可以把虚拟环境目录（venv）加入.gitignore，避免提交到仓库，让用户自行创建虚拟环境后安装依赖。

• 补充：在README里说明依赖安装步骤
  最好在仓库的README文件里写清楚依赖安装流程，比如告诉用户先创建虚拟环境，再执行pip install -r requirements.txt，降低用户的上手成本。

内容的提问来源于stack exchange，提问作者Tchaly Leandre Jr.