以下是使用requirements.txt安装Python依赖的完整指南:

一、基础安装流程

  1. 环境检查
    确保已安装Python和pip工具,可通过以下命令验证:

    python --version
    pip --version

    若未安装pip,需先执行python -m ensurepip --upgrade‌12

  2. 文件准备
    requirements.txt文件应包含如下格式的依赖项(每行一个包):

    flask==2.0.1
    requests>=2.25.1
    numpy

    版本号精确指定(==)或范围指定(>=)均可‌34

  3. 执行安装
    在包含requirements.txt的目录下运行:

    pip install -r requirements.txt

    多Python版本时建议使用pip3明确指定‌25

二、高级管理技巧

  1. 虚拟环境隔离

    python -m venv myenv # 创建虚拟环境 source myenv/bin/activate # 激活(Linux/Mac) myenv\Scripts\activate # 激活(Windows)

    激活后再安装依赖可避免全局污染‌16

  2. 依赖冲突解决

    • 手动调整requirements.txt中的版本号
    • 使用pip check验证依赖兼容性
    • 优先安装基础依赖再装次级依赖‌14

三、实用命令速查

操作 命令 说明
生成requirements.txt pip freeze > requirements.txt 导出当前环境所有包‌6
跳过已安装包 pip install -r requirements.txt --ignore-installed 避免重复安装‌5
仅安装核心依赖 pip install -r requirements.txt --no-deps 不安装次级依赖‌4

四、常见问题处理

  • 权限不足‌:添加--user参数或使用sudo(Linux)‌2
  • 网络超时‌:换用国内镜像源(如-i https://pypi.tuna.tsinghua.edu.cn/simple)‌1
  • 哈希校验失败‌:添加--disable-pip-version-check跳过检查
Logo

魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。

更多推荐