当前位置:知识文库 ❯ 图文

pip包管理器

概述

pip是Python的官方包管理工具，用于安装、卸载和管理Python第三方包。Python拥有庞大的第三方库生态，通过pip可以轻松地安装和管理这些库。本教程将全面介绍pip的使用方法，包括安装包、卸载包、查看已安装包、升级包、导出依赖、使用国内镜像源等内容，帮助你高效管理Python项目依赖。

pip简介

什么是pip

pip是"pip installs packages"的递归缩写，是Python的包安装程序。它从Python Package Index（PyPI）下载并安装包。

pip是否已安装

Python 3.4及以上版本默认包含pip。检查pip是否已安装：

代码示例

pip --version

或：

代码示例

python -m pip --version

提示：推荐使用 python -m pip 的方式调用pip，这样可以确保pip与当前使用的Python解释器匹配。

升级pip

代码示例

python -m pip install --upgrade pip

安装包

基本安装

代码示例

pip install requests

安装指定版本

代码示例

pip install requests==2.31.0

安装最低版本

代码示例

pip install requests>=2.28.0

安装兼容版本

代码示例

pip install requests~=2.31.0

~=2.31.0 表示安装 2.31.x 系列的最新版本，但不升级到 2.32.0。

从requirements文件安装

代码示例

pip install -r requirements.txt

从Git仓库安装

代码示例

pip install git+https://github.com/psf/requests.git

安装本地包

代码示例

pip install ./my_package

以编辑模式安装

代码示例

pip install -e ./my_package

提示：编辑模式安装后，对源码的修改会立即生效，适合开发调试。

仅安装当前用户

代码示例

pip install --user requests

卸载包

卸载单个包

代码示例

pip uninstall requests

卸载多个包

代码示例

pip uninstall requests flask django

卸载时不确认

代码示例

pip uninstall -y requests

通过requirements文件卸载

代码示例

pip uninstall -y -r requirements.txt

查看已安装包

列出所有已安装包

代码示例

pip list

输出示例：

代码示例

Package    Version
---------- -------
pip        24.0
requests   2.31.0
flask      3.0.0

以requirements格式输出

代码示例

pip freeze

输出示例：

代码示例

requests==2.31.0
flask==3.0.0

查看某个包的详细信息

代码示例

pip show requests

输出示例：

代码示例

Name: requests
Version: 2.31.0
Summary: Python HTTP for Humans.
Home-page: https://requests.readthedocs.io
Author: Kenneth Reitz
Author-email: me@kennethreitz.org
License: Apache 2.0
Location: /usr/lib/python3.12/site-packages
Requires: charset-normalizer, idna, urllib3, certifi
Required-by:

检查过期的包

代码示例

pip list --outdated

输出示例：

代码示例

Package    Version Latest Type
---------- ------- ------ -----
requests   2.28.0  2.31.0 wheel

升级包

升级单个包

代码示例

pip install --upgrade requests

升级到指定版本

代码示例

pip install requests==2.31.0

批量升级所有过期包

代码示例

pip list --outdated --format=freeze | grep -v "^\-e" | cut -d = -f 1 | xargs -n1 pip install -U

提示：Windows PowerShell下批量升级：

代码示例

pip list --outdated --format=freeze | ForEach-Object { pip install -U $_.Split('==')[0] }

导出依赖

导出当前环境依赖

代码示例

pip freeze > requirements.txt

requirements.txt格式示例

代码示例

requests==2.31.0
flask==3.0.0
numpy==1.26.2
pandas==2.1.4

在新环境中安装依赖

代码示例

pip install -r requirements.txt

仅导出项目直接依赖

建议手动维护 requirements.txt，只包含项目直接依赖的包，不包含间接依赖。也可以使用 pipreqs 工具：

代码示例

pip install pipreqs
pipreqs /path/to/project

使用国内镜像源

由于网络原因，国内访问PyPI可能较慢，可以使用国内镜像源加速下载。

临时使用镜像源

代码示例

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

永久配置镜像源

创建或编辑pip配置文件：

Windows：%APPDATA%\pip\pip.ini
macOS/Linux：~/.pip/pip.conf

添加以下内容：

代码示例

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

常用国内镜像源

镜像源	地址
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple/
中国科技大学	https://pypi.mirrors.ustc.edu.cn/simple/
豆瓣	https://pypi.douban.com/simple/
腾讯云	https://mirrors.cloud.tencent.com/pypi/simple/
华为云	https://repo.huaweicloud.com/repository/pypi/simple/

常用命令表格

命令	说明
`pip install package`	安装包
`pip install package==version`	安装指定版本
`pip install --upgrade package`	升级包
`pip uninstall package`	卸载包
`pip list`	列出已安装包
`pip list --outdated`	列出过期包
`pip show package`	查看包详情
`pip freeze`	导出依赖列表
`pip install -r requirements.txt`	从文件安装依赖
`pip search keyword`	搜索包（已停用）
`pip check`	检查依赖冲突
`pip config list`	查看配置
`pip cache dir`	查看缓存目录
`pip cache purge`	清除缓存
`pip install --no-cache-dir package`	安装时不使用缓存

代码示例

自动生成requirements.txt的脚本

代码示例

import subprocess
import sys


def generate_requirements(output_file="requirements.txt"):
    result = subprocess.run(
        [sys.executable, "-m", "pip", "freeze"],
        capture_output=True,
        text=True
    )
    
    packages = result.stdout.strip().split("\n")
    packages = [p for p in packages if p and not p.startswith("-e")]
    packages.sort()
    
    with open(output_file, "w", encoding="utf-8") as f:
        f.write("\n".join(packages) + "\n")
    
    print(f"Generated {output_file} with {len(packages)} packages")


if __name__ == "__main__":
    generate_requirements()

检查并升级过期包的脚本

代码示例

import subprocess
import sys


def upgrade_outdated():
    result = subprocess.run(
        [sys.executable, "-m", "pip", "list", "--outdated", "--format=columns"],
        capture_output=True,
        text=True
    )
    
    lines = result.stdout.strip().split("\n")
    if len(lines) <= 2:
        print("All packages are up to date!")
        return
    
    print("Outdated packages:")
    print(result.stdout)
    
    for line in lines[2:]:
        package_name = line.split()[0]
        print(f"Upgrading {package_name}...")
        subprocess.run(
            [sys.executable, "-m", "pip", "install", "--upgrade", package_name]
        )


if __name__ == "__main__":
    upgrade_outdated()

注意事项

不要使用sudo：在Linux/macOS上不要使用 sudo pip install，这可能破坏系统Python环境，使用 --user 或虚拟环境代替
版本锁定：生产环境中建议使用 == 锁定包版本，避免因版本更新导致兼容性问题
依赖冲突：使用 pip check 命令检查是否存在依赖冲突
缓存问题：如果安装出现异常，尝试清除缓存：pip cache purge
网络问题：安装失败时可以尝试更换镜像源或使用代理
requirements.txt维护：建议区分开发依赖和生产依赖，可以使用 requirements-dev.txt 和 requirements.txt 分别管理
pip版本：保持pip为最新版本，以获得更好的性能和功能支持

小结

本教程全面介绍了pip包管理器的使用方法：

pip的基本概念和安装验证
安装、卸载、查看、升级包的各种方式
导出和安装项目依赖
配置国内镜像源加速下载
常用命令速查表
自动化脚本示例

pip是Python开发中不可或缺的工具，熟练掌握pip的使用将大大提升你的开发效率。

练习题

练习1

完成以下pip操作并记录每一步的输出：

查看当前pip版本
升级pip到最新版本
安装 requests 包
查看 requests 包的详细信息
导出当前环境的依赖到 requirements.txt
卸载 requests 包
从 requirements.txt 重新安装依赖

练习2

编写一个Python脚本 package_manager.py，实现以下功能：

接受命令行参数，支持 install、uninstall、list、upgrade 四个命令
install 命令：安装指定的包
uninstall 命令：卸载指定的包
list 命令：列出所有已安装的包
upgrade 命令：升级指定的包

提示：使用 subprocess 模块调用pip命令，使用 argparse 模块解析命令行参数。

常见问题

pip和python -m pip有什么区别？

推荐使用 python -m pip 的方式调用pip，这样可以确保pip与当前使用的Python解释器匹配，避免在多Python环境下出现包安装到错误解释器的问题。

pip安装太慢怎么办？

可以使用国内镜像源加速下载，如清华大学镜像（https://pypi.tuna.tsinghua.edu.cn/simple）。可以临时使用 -i 参数指定镜像，或在配置文件中永久设置。

==、>=、~= 版本标识符有什么区别？

== 表示精确安装指定版本；>= 表示安装大于等于指定版本的最新版本；~= 表示兼容版本，如 ~=2.31.0 表示安装 2.31.x 系列的最新版本，但不升级到 2.32.0。

pip install -e 是什么意思？

-e 表示编辑模式（editable）安装，安装后对源码的修改会立即生效，无需重新安装，非常适合本地包的开发和调试。

为什么不建议使用 sudo pip install？

使用 sudo pip install 会将包安装到系统Python目录，可能破坏系统Python环境，导致系统工具异常。建议使用 --user 参数安装到用户目录，或使用虚拟环境隔离。

标签： pip 包管理器 PyPI 镜像源 requirements Python教程依赖管理

本文涉及AI创作

内容由AI创作，请仔细甄别

list快速访问

poll相关推荐

Python虚拟环境 - venv/virtualenv/conda环境管理

PyCharm安装与配置教程 - Python IDE

VSCode配置Python开发环境

Python 安装 - Linux

快速访问

相关推荐