pip命令大全含换源方法

╰半夏微凉° 2023-09-29 20:19 99阅读 0赞

**目录**

一、命令列表

二、通用选项列表

三、常用操作

1.使用 requirements.txt 安装包

2.生成requirements.txt文件

3.pip升级命令

4.开启向后不兼容的新功能

5.启用已弃用的功能

四、pip换源

1.临时使用pip源方法

2.永久修改方法

--------------------

## 一、命令列表 ##

<table style="width:590px;"> 
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>说明</th> 
   <th style="width:285px;">实例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>install</td> 
   <td>安装包</td> 
   <td style="width:285px;">pip install numpy</td> 
  </tr> 
  <tr> 
   <td>download</td> 
   <td>下载包</td> 
   <td style="width:285px;">pip download numpy</td> 
  </tr> 
  <tr> 
   <td>uninstall</td> 
   <td>卸载包</td> 
   <td style="width:285px;">pip uninstall numpy</td> 
  </tr> 
  <tr> 
   <td>freeze</td> 
   <td>以需求格式输出已安装的包</td> 
   <td style="width:285px;">pip freeze | tee requirements.txt</td> 
  </tr> 
  <tr> 
   <td>inspect</td> 
   <td>检查python环境</td> 
   <td style="width:285px;">pip inspect</td> 
  </tr> 
  <tr> 
   <td>list</td> 
   <td>列出已安装的软件包</td> 
   <td style="width:285px;">pip list</td> 
  </tr> 
  <tr> 
   <td>show</td> 
   <td>显示已安装包的信息，包括版本，依赖，许可证，作者，主页等信息</td> 
   <td style="width:285px;">pip show numpy</td> 
  </tr> 
  <tr> 
   <td>check</td> 
   <td>验证已安装的包具有兼容的依赖项</td> 
   <td style="width:285px;">pip&nbsp;check numpy</td> 
  </tr> 
  <tr> 
   <td>config</td> 
   <td>管理本地和全局配置</td> 
   <td style="width:285px;">pip config list</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>检查和管理pip的whl缓存</td> 
   <td style="width:285px;">pip cache numpy</td> 
  </tr> 
  <tr> 
   <td>wheel</td> 
   <td>将某个包及其依赖变成wheels，并存到指定文件夹</td> 
   <td style="width:285px;"> <p>pip wheel --wheel-dir=/tmp numpy&nbsp;</p> <p>pip wheel --wheel-dir=/tmp -r requirements.txt</p> </td> 
  </tr> 
  <tr> 
   <td>hash</td> 
   <td>计算文件的哈希值</td> 
   <td style="width:285px;"></td> 
  </tr> 
  <tr> 
   <td>completion</td> 
   <td>用于补全命令的辅助命令</td> 
   <td style="width:285px;">pip completion --bash &gt;&gt;~/.profile source ~/.profile</td> 
  </tr> 
  <tr> 
   <td>debug</td> 
   <td>显示对调试有用的信息</td> 
   <td style="width:285px;">pip debug --verbose</td> 
  </tr> 
  <tr> 
   <td>help</td> 
   <td>帮助</td> 
   <td style="width:285px;">pip help</td> 
  </tr> 
 </tbody> 
</table>

## 二、通用选项列表 ##

<table style="width:691px;"> 
 <thead> 
  <tr> 
   <th style="width:157px;">选项</th> 
   <th style="width:204px;">说明</th> 
   <th style="width:328px;">实例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:157px;">&nbsp;-h, --help</td> 
   <td style="width:204px;">命令的帮助信息</td> 
   <td style="width:328px;">pip install -h</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--debug</td> 
   <td style="width:204px;">打印命令的异常等调试信息</td> 
   <td style="width:328px;">pip install numpy --debug&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--isolated</td> 
   <td style="width:204px;">在隔离模式下运行pip，忽略环境变量和用户配置</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--require-virtualenv</td> 
   <td style="width:204px;">允许pip只在虚拟环境中运行;否则将报错退出</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">-v, --verbose</td> 
   <td style="width:204px;">提供更多的输出。最多可以使用3次(对应于WARNING、ERROR和CRITICAL日志级别)</td> 
   <td style="width:328px;">pip show -vvv numpy</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">-V, --version</td> 
   <td style="width:204px;">显示版本并退出</td> 
   <td style="width:328px;">pip &nbsp;-V</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">-q, --quiet</td> 
   <td style="width:204px;">减少输出。最多可以使用3次(对应于WARNING、ERROR和CRITICAL日志级别)</td> 
   <td style="width:328px;">pip show -qqq numpy</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--log &lt;path&gt;</td> 
   <td style="width:204px;">详细追加日志的路径</td> 
   <td style="width:328px;">pip show &nbsp;numpy --log log.txt</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--no-input</td> 
   <td style="width:204px;">禁用输入提示</td> 
   <td style="width:328px;">pip install --no-input -r host-requirements.txt</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--proxy &lt;proxy&gt;</td> 
   <td style="width:204px;">在表单scheme中指定一个代理</td> 
   <td style="width:328px;">scheme://[user:passwd@]proxy.server:port</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--retries &lt;retries&gt;</td> 
   <td style="width:204px;">每个连接尝试的最大重试次数(默认为5次)</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--timeout &lt;sec&gt;&nbsp;</td> 
   <td style="width:204px;">设置socket超时(默认为15秒)</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--exists-action &lt;action&gt;</td> 
   <td style="width:204px;">下载文件或者生成文件时，当路径已经存在时的默认动作:(s)witch， (i)gnore， (w)ipe， (b)ackup， (a)bort。</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--trusted-host &lt;hostname&gt;</td> 
   <td style="width:204px;">将此host标记为受信任的，即使它没有有效的或任何HTTPS</td> 
   <td style="width:328px;">pip install open_clip -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">&nbsp;--cert &lt;path&gt; &nbsp;</td> 
   <td style="width:204px;">&nbsp;pem编码CA证书包路径。如果提供，则覆盖默认值。有关更多信息，请参阅pip文档中的“SSL证书验证”。</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--client-cert &lt;path&gt;</td> 
   <td style="width:204px;">&nbsp;SSL客户端证书路径，包含私钥和PEM格式证书的单个文件</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--cache-dir &lt;dir&gt;&nbsp;</td> 
   <td style="width:204px;">将缓存数据存储在&lt;dir&gt;</td> 
   <td style="width:328px;">pip install --cache-dir=/tmp -r requirements.txt</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--no-cache-dir&nbsp;</td> 
   <td style="width:204px;">禁用缓存</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">&nbsp;--disable-pip-version-check</td> 
   <td style="width:204px;">不要定期检查PyPI，以确定是否有新版本的pip可供下载。使用之后不再提示升级pip</td> 
   <td style="width:328px;">pip install numpy &nbsp;--disable-pip-version-check</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--no-color &nbsp;</td> 
   <td style="width:204px;">抑制输出的彩色打印</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--no-python-version-warning</td> 
   <td style="width:204px;">不对即将不支持的python进行警告</td> 
   <td style="width:328px;"></td> 
  </tr> 
  <tr> 
   <td style="width:157px;">--use-feature &lt;feature&gt;</td> 
   <td style="width:204px;">启用可能向后不兼容的新功能</td> 
   <td style="width:328px;">pip install PyQt6-tools -i https://pypi.douban.com/simple --use-feature=2020-resolver</td> 
  </tr> 
  <tr> 
   <td style="width:157px;">&nbsp;--use-deprecated &lt;feature&gt;</td> 
   <td style="width:204px;">启用已弃用的功能，这些功能将在未来被删除</td> 
   <td style="width:328px;">pip install hanlp --use-deprecated=legacy-resolver</td> 
  </tr> 
 </tbody> 
</table>

## 三、常用操作 ##

### 1.使用 requirements.txt 安装包 ###

pip install -r requirements.txt

### 2.生成requirements.txt文件 ###

生成 requirements.txt会用到freeze命令freeze命令和list命令很想，只是不会显示pip等无法用pip安装和卸载的包。

# windows生成requirements.txt
    pip freeze > requirements.txt
    
    # linux生成requirements.txt
    pip freeze | tee requirements.txt

### 3.pip升级命令 ###

python -m pip install --upgrade pip

### 4.开启向后不兼容的新功能 ###

> ERROR: After October 2020 you may experience errors when installing or updating package s. This is because pip will change the way that it resolves dependency conflicts. We recommend you use --use-feature=2020-resolver to test your packages with the new res olver before it becomes the default.

当出现类似上面的报错时，证明包有新的功能，但是可能会破坏一些现有的设置，所以这些新功能是默认关闭的，如果一定要使用这些新功能可以加入--use-feature参数并指定新的功能：

pip install example --use-feature=2020-resolver

### 5.启用已弃用的功能 ###

因为安装时有版本冲突，缺少某些方法，可以用--use-deprecated暂时解决。

> pip is looking at multiple versions of urllib3 to determine which version is compatible with other requirements. This could take a while.

如果安装rasa进入死循环找版本，一直报上面的错，可以这样：

pip install rasa -i http://mirrors.aliyun.com/pypi/simple/   --trusted-host mirrors.aliyun.com    --use-deprecated=legacy-resolver

如果安装elenium报错error: metadata-generation-failed，可以这样

pip install selenium --use-deprecated=backtrack-on-build-failures

## 四、pip换源 ##

> ERROR: Could not find a version that satisfies the requirement tensorflow-hub (from versions: none)  
> ERROR: No matching distribution found for tensorflow-hub

如果包下载慢或者出现上面的报错，可以试试换源。

### 1.临时使用pip源方法 ###

可以在使用pip的时候加参数 -i，如：

pip install open_clip -i http://pypi.douban.com/simple/ --trusted-host pypi.douban.com

### 2.永久修改方法 ###

linux下，修改 ~/.pip/pip.conf (没有就创建一个)

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

windows下，直接在user目录中创建一个pip目录，文件输入框：%USERPROFILE%，如：C:\\Users\\Administrator\\pip，新建文件pip.ini，即：%USERPROFILE%\\pip\\pip.ini，内容如下：

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

**常用的源：**

清华大学：https://pypi.tuna.tsinghua.edu.cn/simple/

阿里云：http://mirrors.aliyun.com/pypi/simple/