pip详解（持续更新ing...）

诸神缄默不语-个人技术博文与视频目录

1. pip简介

一种用于管理Python包的工具。

pip文档：User Guide - pip documentation v22.1.1

在virtualenv或conda create的虚拟环境下直接使用pip，就可以将包安装在指定环境下。如果不在Python环境下，需要在命令行前面加上 python -m（如果Python解释器不在默认路径，就用完整的解释器路径，举例：/home/myusername/anaconda3/envs/envname/bin/python -m）

2. pip install

1. 直接安装包，示例代码：pip install numpy（一般建议参考包官网及pypi官网，了解具体的包安装方式）
2. 可以直接通过这一方式安装最新版本的常用包（不便直接使用pip install的包一般都在其官网有写具体的安装方式，部分包我撰写过相应的安装指南）
   1. numpy：pip install numpy
   2. scipy：pip install scipy 官网安装教程：SciPy - Installation
   3. scikit-learn (sklearn)：pip install scikit-learn 官网下载教程：Installing scikit-learn — scikit-learn 1.1.1 documentation
   4. matplotlib: pip install matplotlib 官网入门教程：Getting started — Matplotlib 3.5.3 documentation
   5. wordcloud：pip install wordcloud pypi网站：wordcloud · PyPI（虽然网页上只说测试到了Python3.7，其实Python3.8也能用），文档：WordCloud for Python documentation — wordcloud 1.8.1 documentation，官方博文：A Wordcloud in Python，GitHub项目：amueller/word_cloud: A little word cloud generator in Python
   6. gensim：pip install gensim 官网：Gensim: Topic modelling for humans
   7. pyLDAvis：pip install pyldavis 官方文档：pyLDAvis — pyLDAvis 2.1.2 documentation
   8. tqdm：pip install tqdm 官方GitHub项目：tqdm/tqdm: A Fast, Extensible Progress Bar for Python and CLI
   9. seaborn：pip install seaborn 官网下载教程：Installing and getting started — seaborn 0.11.2 documentation
   10. sentence_transformers: pip install sentence_transformers 官网：sentence-transformers (Sentence Transformers)
   11. pybind11：pip install pybind11 官网下载教程：Installing the library — pybind11 documentation
3. 指定安装某一版本的包，示例代码：pip install numpy==1.14
4. 通过源码安装包（以textgen包¹为例）：

git clone https://github.com/shibing624/textgen.git
cd textgen
python setup.py install

通过源码安装包，在源码更新时同时更新包的方法：
（待补）

5. 如果出现网络问题等，无法直接通过包名下载，也可以将指定包的whl文件下载后，通过pip直接安装whl文件，示例代码：pip install torch_scatter-2.0.9-cp39-cp39-linux_x86_64.whl
   另一种方式是，如果能确定操作系统和版本是一致的，也可以在另一个（能安装这个包的）环境里安装好，然后把虚拟环境中的整个包挪过来。反正有时是能用的。
6. 参数
   1. --upgrade 或 -U 更新包到最新版本，示例代码：pip install --upgrade numpy（文档地址：https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-U）
   2. 参数 --pre 下载pre-release或development版本。（默认情况下pip会搜索stable版本的包） 示例代码：pip install --pre dgl-cu102 -f https://data.dgl.ai/wheels-test/repo.html
   3. 参数 -i 指定源，示例代码：pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple cogdl
      大陆常用镜像：https://pypi.tuna.tsinghua.edu.cn/simple  pypi | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror
   4. 参数 -r 指定requirements.txt，示例代码：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple（使用了清华源）
   5. 参数 -e, --editable <path/url> 以editable mode，从本地项目路径或一个VCS URL安装包。示例代码：pip install -e .
   6. 参数 --user 安装到Python用户的install directory里，一般来说是~/.local/，Windows平台一般是%APPDATA%Python，可以查看Python文档里的site.USER_BASE（对应网址：site — Site-specific configuration hook — Python 3.10.4 documentation）来了解详情。（文档地址：https://pip.pypa.io/en/stable/cli/pip_install/#install-user）
   7. 参数 -i, --index-url <url> Python包搜索位置。默认值：https://pypi.org/simple
   8. 参数 --extra-index-url <url> --index-url的补充超链接
   9. 参数 -f- 可以指定在某网页中搜索下载指定版本的包（一般都是包官方给出的安装方式），示例代码：pip install torch-scatter -f https://data.pyg.org/whl/torch-1.10.0+cu102.html

3. pip show 展示包的信息

示例代码：pip show numpy
打印信息：

Name: numpy
Version: 1.21.2
Summary: NumPy is the fundamental package for array computing with Python.
Home-page: https://www.numpy.org
Author: Travis E. Oliphant et al.
Author-email: 
License: BSD
Location: /home/myusername/anaconda3/envs/envname/lib/python3.8/site-packages
Requires: 
Required-by: transformers, torchvision, torch, scipy, pandas, mkl-random, mkl-fft, matplotlib

4. pip list 打印已安装的包的简略信息

打印的示例（部分）：

Package                       Version
----------------------------- ----------
anyio                         3.4.0
argon2-cffi                   20.1.0
async-generator               1.10
attrs                         21.2.0
Babel                         2.9.1
backcall                      0.2.0
backports.functools-lru-cache 1.6.4

5. pip cache dir 打印pip的cache文件夹

6. pip cache purge 手动清除缓存²

7. which pip 打印pip的路径

8. 永久修改pip下载源（本文以清华源为例，其他源改成对应链接即可）

1. 方法一：在 .pip/pip.conf（Linux/Unix）或%HOME%\pip\pip.ini（Windows）文件中添加以下内容：

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

2. 方法二：在.condarc中增加如下内容³：

show_channel_urls: true
default_channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2
custom_channels:
  conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  deepmodeling: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/

9. 镜像

清华镜像：https://mirrors.tuna.tsinghua.edu.cn/help/pypi/

---

1. shibing624/textgen: TextGen: Implementation of Text Generation models, include LLaMA, BLOOM, GPT2, BART, T5, SongNet and so on. 文本生成模型，实现了包括LLaMA，ChatGLM，BLOOM，GPT2，Seq2Seq，BART，T5，UDA等模型的训练和预测，开箱即用。 ↩︎

2. 【Python】pip安装库时存在缓存（及清除方法）_pip清理缓存的包_爱打瞌睡的CV君的博客-优快云博客 ↩︎

3. anaconda | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror ↩︎