Python-pip

发布于: 2025-03-15 15:35:26 更新于: 2025-03-15 17:45:26 分类： 开 发 标签： Tag(name='Python', count=10)

Python 包管理工具 pip 使用笔记

pip 是 Python 的官方包管理器，用于从 PyPI(Python Package Index) 安装、升级和管理第三方库。自 Python 3.4 起，pip 已内置在 Python 安装中。

pip 安装的包在哪个目录？

Python 的包通常会被安装在 Python 的 site-packages 目录下。这个目录的具体位置取决于你的操作系统和 Python 的安装方式。 可以通过 print(site.getsitepackages()) 查看包安装目录，进入 python 命令行，执行

Python 3.11.8 (main, Feb 11 2025, 20:45:56) [Clang 13.0.0 (clang-1300.0.27.3)] on darwin
>>> import site
>>> print(site.getsitepackages())
['/Users/user/.pyenv/versions/3.11.8/lib/python3.11/site-packages']

pip -V 查看pip版本

-V, --version 查看 pip 版本

pip -V
pip --version
pip 24.0 from /Users/user/.pyenv/versions/3.11.11/lib/python3.11/site-packages/pip (python 3.11)

pip freeze 查看依赖清单

以 requirements 文件的格式输出已安装的包

# pip freeze
acres==0.3.0
allure-pytest==2.9.45

pip freeze 导出依赖清单到 requirements.txt

常用方式为 pip freeze > requirements.txt 导出依赖清单到 requirements.txt 文件。

pip list 查看已安装的包

pip list
Package    Version
---------- -------
pip        24.0
setuptools 65.5.0

pip list -o/--outdated 查看过期需更新的包

-o, --outdated 查看过期需更新的包

pip list --outdated
Package    Version Latest Type
---------- ------- ------ -----
pip        24.0    25.0.1 wheel
setuptools 65.5.0  75.8.0 wheel

pip show pkg 查看包安装位置

pip show powerline-status
Name: powerline-status
Version: 2.7
Summary: The ultimate statusline/prompt utility.
Home-page: https://github.com/powerline/powerline
Author: Kim Silkebaekken
Author-email: kim.silkebaekken+vim@gmail.com
License: MIT
Location: /Users/user/.local/lib/python3.11/site-packages
Requires:
Required-by:

pip search name 搜索包

pip install 安装升级包

pip install pkg  # 安装包的最新版本
pip install pkg==1.1.0  # 安装包的指定版本
pip install pkg>=1.1.0  # 指定安装的最小版本

pip install -i 指定包索引安装包

-i, --index-url <url> 指定镜像源，默认是 https://pypi.org/simple 临时使用清华大学镜像安装某个包 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package

pip install -r requirements.txt 根据依赖文件批量安装

-r, --requirement <file> 选项用于指定包含依赖关系规范的文件，通常称为 "requirements 文件"。 该选项可以多次使用，每次指定一个 requirements 文件，例如 pip install -r requirements1.txt -r requirements2.txt 通过使用这个选项，你可以一次性安装多个包，而无需逐个列出每个包的名称和版本。

Python 项目中的 requirements.txt 用于记录所有依赖包及其精确的版本号，以便新环境部署。

1、在虚拟环境中使用 pip 生成： pip freeze > requirements.txt

2、在新的虚拟环境中安装依赖： pip install -r requirements.txt 指定国内镜像： pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ -r requirements.txt

pip install -U/--upgrade pkg 升级包

-U, --upgrade 升级包

pip install -U/--upgrade pip 升级pip

pip install -U pip pip install --upgrade pip 升级 pip

pip install --user 安装到用户级目录

--user 将 Python 包安装到用户级别的目录，而不是系统级别的目录。 这对于没有管理员权限的用户特别有用，因为它允许在不影响系统中其他用户的情况下安装和管理 Python 包。 具体来说，使用 --user 选项会将包安装到用户主目录下的一个特定路径中，通常是 ~/.local/lib/pythonX.Y/site-packages/，其中 X.Y 是你的 Python 版本号。 例如 pip install powerline-status --user

pip install -e 可编辑模式安装

-e, --editable 以开发者模式（或者说是可编辑模式）安装包。这种模式下，包的源代码会被链接到 Python 的 site-packages 目录下，而不是像普通安装那样被复制过去。这样就可以在不重新安装的情况下测试和调试包中的代码了。只要修改源代码，改动就会立即生效。 可编辑模式通常被称为 setuptools 的 "develop mode"，它允许你在本地进行开发，并在修改代码后立即看到变化，而不需要重新安装包。

pip install -e . 以开发者模式在当前目录下安装 Python 包。

pip install pkg==1.0.0 指定版本号安装

通过使用 ==, >=, <=, >, < 来指定一个版本号。 例如

pip install SomePackage              # 最新版本
pip install SomePackage==1.0.4       # 指定版本
pip install 'SomePackage>=1.0.4'     # 最小版本
pip install 'package~=1.4.2'         # 允许1.4.2及以上，但＜1.5.0
pip install 'package>=1.0.0,<2.0.0'  # 版本需≥1.0.0且＜2.0.0
pip install 'Markdown<2.0' 
pip install 'Markdown>2.0,<2.0.3'

pip install pkg[standard] 指定包可选项安装

pip install pkg[选项] 安装包时同时启用某些可选功能或依赖项 选项可以是单个或多个（用逗号分隔），例如 pip install django[mysql,redis]

实现原理：包的 setup.py 中通过 extras_require 定义可选依赖项。 例如，uvicorn[standard] 实际会安装 uvicorn 及其依赖的 uvloop, httptools 等高性能组件，而默认安装可能仅包含基础功能。

pip install xx.whl 安装wheel文件

提前在 pypi 下载包的 wheel 文件 然后 pip install xx.whl

pip uninstall pkg 卸载包

pip config 配置

Python 配置项优先级

总之就是作用范围越小的配置优先级越高，优先级从高到低:

  • 命令行参数：例如 pip install -i 可指定本次命令使用的包索引
  • 项目级：项目目录下的 pip.conf
  • 虚拟环境级：<venv>/pip.ini 或 <venv>/pip.conf
  • 用户级：
    • Windows：C:\Users\<用户名>\AppData\Roaming\pip\pip.ini
    • Linux/Mac：~/.pip/pip.conf 或 ~/.config/pip/pip.conf
  • 全局级：
    • Windows：C:\ProgramData\pip\pip.ini
    • Linux/macOS：/etc/pip.conf

pip config set 修改配置

pip config set global.index-url 全局包索引改为清华

pip 默认包索引（镜像源）是 Python Package Index (PyPI) https://pypi.org/simple

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Writing to /Users/user/.config/pip/pip.conf

常用国内镜像源：

  • 清华大学镜像 https://pypi.tuna.tsinghua.edu.cn/simple
  • 阿里云镜像 https://mirrors.aliyun.com/pypi/simple/
  • 华为云镜像 https://mirrors.huaweicloud.com/repository/pypi/simple/
  • 豆瓣镜像 https://pypi.douban.com/simple/

pip config set global.extra-index-url 额外包索引

pip config set global.extra-index-url http://pip.baidu.com/root/baidu/+simple/

pip config set global.trusted-host 信任域名

pip config set global.trusted-host pip.baidu.com

pip config list 查看配置

pip config list
global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'

pip config get 查看配置项

pip config get global.index-url
https://pypi.tuna.tsinghua.edu.cn/simple

# 查看的配置项不存在时：
pip config get global.index-url
ERROR: No such key - global.index-url

pip config unset 删除配置

pip config unset global.index-url

pip config edit 编辑配置文件

pip3 离线安装 PyYAML 包

1、下载 PyYAML Wheel 包 https://pypi.org/project/PyYAML/#files 下载 PyYAML-6.0.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

2、将 whl 文件上传到服务器，执行 pip3 install xx.whl 安装 pip3 install PyYAML-6.0.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl