python 包管理工具 pip 的配置

近几年来，python的包管理系统pip 越来越完善，尤其是对于 windows场景下，pip大大改善了python的易用性。
本文对 pip 工具相关配置进行描述。
https://www.cnblogs.com/yvivid/p/pip_setup.html

一、python 包管理工具 pip 安装

从 python 3.4开始 内嵌 pip，后续版本无需单独安装。

1.1 安装 pip

如果 用的 python3 版本还没有包含 pip，可通过下面地址找到 get-pip.py 下载，

• https://packaging.python.org/en/latest/tutorials/installing-packages/
• https://pip.pypa.io/en/stable/installation/

并 通过 python get-pip.py 安装

注意：get-pip.py 和 python3.x 需要匹配；对于 python3.4 等 历史python版本，
需从 https://github.com/pypa/get-pip 找到相应的 get-pip.py 版本。

1.2 修复 pip

修复 pip.exe（Python3xx\Scripts文件夹下），通过 ensurepip 模块 来修复：
python -m ensurepip --upgrade

二、python 包管理工具 pip 配置

由于外部服务器下载速率较低，国内一般都映射到镜像服务器。

2.1、临时指定pip库路径

windows下CMD执行：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package

注意：simple 不能少；是 https 而不是 http；

2.2 永久指定pip库路径

• pip >= 10.0.0 版本时 ，通过下面命令，实现镜像服务器的配置：
  pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

• pip < 10.0.0 版本时，通过下面命令 先升级pip到 高于10.0.0的版本：
  python -m pip install --upgrade pip

• pip < 10.0.0 版本 & 不想升级pip时，通过下面的方式实现：
  linux下 修改 $HOME/.pip/pip.conf 文件 (没有就创建一个)；
  windows7/10 下 修改 %APPDATA%\pip\pip.ini 文件 (没有就创建一个)；

注1：.pip.conf 或 pip.ini 文件内容(UTF-8编码）如下：
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

三、python 包管理工具 pip 使用

3.1、查看已安装包

pip list 【列出已安装包】
pip list -o 【列出已安装包 中 哪些已经有更新】
pip freeze > req.txt 【Freeze导出格式，方便用于 pip 批量安装】

3.2、包的安装

pip search numpy
pip install numpy
pip install numpy==1.17.0 【指定版本：通过==, >=, <=, >, < 来指定版本】
pip install -r req.txt【批量安装：基于Freeze 导出格式文件】

3.3、包的版本升级

pip install -U numpy

【对于 linux 自带的 python】通过 pip 升级时，不应直接覆盖 linux 自带 python 应用库，需利用 --user 参数。
pip install --user -U numpy
会将Python 程序包安装到 $HOME/.local 路径下，包含三个文件夹：bin，lib 和 share。

3.4、包的卸载

pip uninstall numpy
pip uninstall -r req.txt　【批量卸载：基于Freeze 导出格式文件】

四、Python env 小技巧

4.1、Windows CMD 快捷方式的设置 【环境变量不含python路径时】

Windows 64bit系统：
%windir%\system32\cmd.exe /K "set PATH=C:\Python38;C:\Python38\DLLs;C:\Python38\Scripts;%PATH%"

Windows 32bit系统：
%windir%\SysWOW64\cmd.exe /K "set PATH=C:\Python38;C:\Python38\DLLs;C:\Python38\Scripts;%PATH%"

注意PATH的顺序：
在win10中，%PATH% 包含%USERPROFILE%\AppData\Local\Microsoft\WindowsApps，会优先相应python。

4.2、Windows 下 环境重置

通过 pip -V 可判断 pip 实际指向的 版本号 & 路径地址。

pip -V
pip 20.0.2 from c:\python38\lib\site-packages\pip (python 3.8)

重新生成 pip.exe，可通过 python -m pip install --force-reinstall pip ，或 上面提到的 ensurepip 模块来实现。

注意：pip.exe包含python程序路径，复制的 python 程序文件夹需要重新生成 pip.exe。

五、PYPI 库资源

• https://pypi.org/ 【PYPI主服务器】
• https://pypi.org/project/pip/ 【pip说明】
• https://mirrors.tuna.tsinghua.edu.cn/help/pypi/ 【清华大学镜像 配置方法】
• https://developer.aliyun.com/mirror/pypi 【阿里云镜像 配置方法】

【原创文档，引用请声明出处，yvivid】
https://www.cnblogs.com/yvivid/p/pip_setup.html

修改记录

2019年10月：创建；
2020年09月：补充 linux下 pip 相关注意事项；
2022年02月：更新 pip 安装及修复相关信息；

---