还在逐个pip install一文掌握批量安装、环境导出、镜像加速让依赖管理变简单 为什么需要requirements.txt在Python项目开发中我们经常需要安装大量依赖库比如PyQt5、OpenCV、pymodbus等。逐个执行pip install命令不仅繁琐还容易遗漏、出现版本冲突。最高效的解决方案创建requirements.txt文件写入所有需要的库名可指定版本然后一条命令批量安装全部依赖。本文全程实操从创建文件→编写清单→批量安装→导出环境新手也能快速上手。 一、什么是requirements.txtrequirements.txt是Python项目的「依赖清单文件」本质是一个纯文本文件核心作用是作用说明记录依赖列出项目所需的所有第三方库及版本一键安装通过pip install -r requirements.txt批量安装环境复现团队成员/部署服务器可快速搭建相同环境版本锁定指定精确版本避免兼容性问题重点文件名建议固定为requirements.txtPython生态通用约定pip工具可直接识别后缀必须是.txt注意不要写成requirements.txt.txt需开启电脑文件后缀显示。✍️ 二、实操步骤创建编写requirements.txt全程以「PyCharm项目」为例三种创建方法任选一种新手优先选方法1。方法1手动创建最直观适配场景新手、不熟悉终端命令直接通过PyCharm图形界面操作零门槛。在PyCharm中右键点击项目根目录→New→File输入文件名requirements.txt按回车确认双击打开文件开始编写依赖清单补充提示如果找不到项目根目录可通过PyCharm左侧「Project」面板查看确保文件和核心代码同级避免后续执行命令时找不到文件。方法2终端快速创建适配场景习惯用终端操作快速创建空文件无需图形界面点击。# Windows/Linux/macOS 通用 touch requirements.txt或者使用# 创建并同时写入初始内容 echo # Python项目依赖清单 requirements.txt方法3使用pip freeze导出已有环境时最便捷适配场景你已经手动安装好了所有需要的库想快速生成依赖清单。pip freeze requirements.txt执行后会自动生成requirements.txt写入当前环境所有已安装的第三方库及对应版本。 三、编写requirements.txt内容语法超简单语法规则每行写一个库名可按需指定版本推荐指定避免版本兼容问题#开头的行是注释不会被执行可用于标注库的用途 写法1基础版只写库名安装最新稳定版适合对库版本无特殊要求只想快速安装简洁高效。# Python上位机依赖清单 # 界面开发PyQt5 PyQt5 pyqt5-tools # PLC通信相关Modbus S7协议 pymodbus python-snap7 # 相机对接 视觉处理 opencv-python # 辅助工具 numpy # 保存数据到Excel openpyxl # 串口通信 pyserial 写法2进阶版指定版本推荐项目使用推荐理由Python库版本更新快不同版本可能存在兼容性问题比如PyQt5高版本和pyqt5-tools不匹配。指定版本能确保环境一致性。格式库名版本号前后无空格# Python上位机依赖清单指定版本稳定兼容 # 界面开发PyQt5稳定版本 PyQt55.15.9 pyqt5-tools5.15.9.3.0.1 # PLC通信适配PLCSIM Advanced 5.0 pymodbus2.5.3 # Modbus TCP通信 python-snap71.4.1 # S7协议对接西门子PLC # 相机对接 视觉处理 opencv-python4.8.1.78 # 稳定版避免取流卡顿 # 辅助工具 numpy1.24.3 # 适配OpenCV 4.8.1 openpyxl3.1.2 # 操作Excel pyserial3.5 # 串口通信 写法3版本范围指定了解即可操作符示例说明numpy1.24.3精确匹配指定版本numpy1.20.0安装大于等于指定版本numpy1.25.0安装小于等于指定版本~numpy~1.24.0兼容版本允许补丁版本更新 四、关键步骤批量安装所有依赖编写完requirements.txt后无需逐个执行pip install一条命令就能批量安装所有库。1. 打开终端切换到项目根目录打开PyCharm的Terminal终端底部默认已经在项目根目录。若不在输入以下命令切换cd D:\PyCharmProjects\PLC_Camera_UpperComputer # 示例路径替换成你自己的2. 核心安装命令必记基础命令从官方PyPI源安装pip install -r requirements.txt执行后pip会自动读取requirements.txt中的所有库逐个下载、安装终端会显示安装进度全部显示Successfully installed即安装完成。3. 优化命令国内镜像源加速重点避坑国内网络访问Python官方PyPI源国外服务器速度慢经常出现超时、安装失败的问题。推荐使用国内镜像源加速# 阿里云镜像源推荐速度快 pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ # 清华镜像源备选稳定 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/ # 中科大镜像源备用 pip install -r requirements.txt -i https://pypi.mirrors.ustc.edu.cn/simple/补充镜像源只是加速下载安装的库和官方源完全一致无需担心版本问题。4. 永久配置镜像源一劳永逸如果不想每次安装都加-i参数可以永久配置清华镜像源pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn配置后每次pip install自动走镜像源无需再加-i参数。 五、实用拓展命令必记提升效率1. 导出当前环境的所有库到requirements.txt场景手动安装好所有库后想快速生成requirements.txt用于备份或分享。pip freeze requirements.txt执行后会自动覆盖或生成requirements.txt写入当前环境所有已安装的Python库及对应版本。⚠️注意pip freeze会导出所有已安装包包括间接依赖可能包含一些不需要的库。如需只导出项目直接依赖可使用pipreqs工具2. 批量卸载所有依赖慎用场景清理开发环境、重新配置依赖执行以下命令会批量卸载requirements.txt中的所有库pip uninstall -r requirements.txt -y说明-y 参数表示“自动确认卸载”无需逐个输入y确认提升效率慎用避免误删环境。3. 安装时指定requirements.txt路径场景requirements.txt不在当前终端目录下比如放在桌面无需切换目录直接指定文件路径即可pip install -r D:\Desktop\requirements.txt -i https://mirrors.aliyun.com/pypi/simple/4. 查看已安装包列表pip list5. 查看过期包pip list --outdated 总结核心命令速查表操作命令批量安装pip install -r requirements.txt镜像加速安装pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/导出依赖清单pip freeze requirements.txt批量卸载pip uninstall -r requirements.txt -y查看已安装包pip list永久配置镜像源pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple 如果觉得有用欢迎点赞、收藏、转发更多Python开发技巧持续更新中