前言
在使用 Python 进行开发时,第三方依赖库(如 requests
、flask
、fastapi
等)是必不可少的。无论是搭建 Web 服务、进行数据分析,还是机器学习任务,依赖库的安装都是最基础的操作之一。
本文将从 Python 的安装方式 和 pip 包管理工具的使用 两方面出发,带你快速掌握依赖安装的方法。同时,我们也会介绍如何通过国内镜像源加速依赖下载,避免因为网络原因导致安装速度过慢甚至失败。
1 Python 安装
1.1 源码安装(Linux 示例)
tar -zxvf ***.tar.gz
cd python-xxx
python3 setup.py install
如果需要手动编译 Python,可以使用源码方式安装。但一般情况下,推荐使用操作系统自带的包管理工具(如 apt
、yum
)或官方安装包。
2 pip 安装第三方依赖
在国内直接使用 pip install
时,可能因为网络问题导致速度很慢,甚至无法安装。因此,推荐使用国内镜像源加速下载。
2.1 常用国内源
# 腾讯
http://mirrors.tencentyun.com/pypi/simple
# 阿里
https://mirrors.aliyun.com/pypi/simple
# 豆瓣
https://pypi.douban.com/simple
# 中科大
https://pypi.mirrors.ustc.edu.cn/simple/
# 清华
https://pypi.tuna.tsinghua.edu.cn/simple
2.2 更新 pip
python3.8 -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
2.3 单次换源
当电脑有多个 Python 解释器时,最好带上版本号使用:
pip3.7 install bottle -i https://pypi.douban.com/simple
pip3.6 install requests -i https://pypi.douban.com/simple
如果只有一个解释器,可以直接使用:
pip install lxml -i https://pypi.douban.com/simple
pip install bs4 -i https://pypi.douban.com/simple
pip install tornado -i https://pypi.douban.com/simple
pip install twisted -i https://pypi.douban.com/simple
实战演练:安装 FastAPI
# 安装最新版本
pip install fastapi -i https://mirrors.aliyun.com/pypi/simple
# 安装指定版本
pip install fastapi==0.115.5 -i https://mirrors.aliyun.com/pypi/simple
2.4 永久换源
2.4.1 Linux 配置
vim ~/.pip/pip.conf # 如果没有就创建
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
2.4.2 Windows 配置
在目录 C:\Users\Administrator\pip.ini
中创建文件:
[global]
timeout = 6000
index-url = http://pypi.douban.com/simple
trusted-host = pypi.douban.com
2.4.3 测试
pip install fastapi==0.115.5
3 Whl 包安装
有时候因为网络问题、版本兼容问题,或者某些包在 pip 上下载太慢,可以选择 下载 .whl
文件(wheel 格式) 然后离线安装。
3.1 什么是 whl 文件?
.whl
是 Python 的 预编译安装包格式,类似于 Windows 的 .exe
安装程序。
- 使用
.whl
安装比从源码编译更快,尤其是一些需要编译 C 扩展的库(如 numpy
、pandas
、lxml
等)。
3.2 whl 文件下载方式
可以到以下网站下载对应版本的 .whl
文件:
- PyPI 官方仓库
- Unofficial Windows Binaries for Python(Windows 常用)
下载时需要注意:
- Python 版本(如 cp37 表示 Python3.7,cp310 表示 Python3.10)
- 系统架构(如 win32、win_amd64、manylinux 等)
3.3 whl 文件安装
进入下载好的 .whl
文件所在目录,使用以下命令安装:
# 例如当前目录有 numpy-1.21.6-cp39-cp39-win_amd64.whl
pip install numpy-1.21.6-cp39-cp39-win_amd64.whl
如果有多个解释器,也可以指定 pip 版本:
pip3.9 install xxx.whl
pip3.10 install xxx.whl
5 依赖存储路径
linux:
./Python-3.8.5/lib/python3.8/site-packages
windows:
C:\Users\Administrator\AppData\Local\Programs\Python\Python38\Lib\site-packages
<h2><a id="_0"></a>前言</h2>
<p>在使用 Python 进行开发时,第三方依赖库(如 <code>requests</code>、<code>flask</code>、<code>fastapi</code> 等)是必不可少的。无论是搭建 Web 服务、进行数据分析,还是机器学习任务,依赖库的安装都是最基础的操作之一。</p>
<p>本文将从 <strong>Python 的安装方式</strong> 和 <strong>pip 包管理工具的使用</strong> 两方面出发,带你快速掌握依赖安装的方法。同时,我们也会介绍如何通过国内镜像源加速依赖下载,避免因为网络原因导致安装速度过慢甚至失败。</p>
<h2><a id="1_Python__6"></a>1 Python 安装</h2>
<h3><a id="11_Linux__8"></a>1.1 源码安装(Linux 示例)</h3>
<pre><div class="hljs"><code class="lang-shell">tar -zxvf ***.tar.gz
cd python-xxx
python3 setup.py install
</code></div></pre>
<p>如果需要手动编译 Python,可以使用源码方式安装。但一般情况下,推荐使用操作系统自带的包管理工具(如 <code>apt</code>、<code>yum</code>)或官方安装包。</p>
<h2><a id="2_pip__18"></a>2 pip 安装第三方依赖</h2>
<p>在国内直接使用 <code>pip install</code> 时,可能因为网络问题导致速度很慢,甚至无法安装。因此,推荐使用国内镜像源加速下载。</p>
<h3><a id="21__22"></a>2.1 常用国内源</h3>
<pre><div class="hljs"><code class="lang-shell"><span class="hljs-meta"># </span><span class="language-bash">腾讯</span>
http://mirrors.tencentyun.com/pypi/simple
<span class="hljs-meta"># </span><span class="language-bash">阿里</span>
https://mirrors.aliyun.com/pypi/simple
<span class="hljs-meta"># </span><span class="language-bash">豆瓣</span>
https://pypi.douban.com/simple
<span class="hljs-meta"># </span><span class="language-bash">中科大</span>
https://pypi.mirrors.ustc.edu.cn/simple/
<span class="hljs-meta"># </span><span class="language-bash">清华</span>
https://pypi.tuna.tsinghua.edu.cn/simple
</code></div></pre>
<h3><a id="22__pip_37"></a>2.2 更新 pip</h3>
<pre><div class="hljs"><code class="lang-shell">python3.8 -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
</code></div></pre>
<h3><a id="23__43"></a>2.3 单次换源</h3>
<p>当电脑有多个 Python 解释器时,最好带上版本号使用:</p>
<pre><div class="hljs"><code class="lang-shell">pip3.7 install bottle -i https://pypi.douban.com/simple
pip3.6 install requests -i https://pypi.douban.com/simple
</code></div></pre>
<p>如果只有一个解释器,可以直接使用:</p>
<pre><div class="hljs"><code class="lang-shell">pip install lxml -i https://pypi.douban.com/simple
pip install bs4 -i https://pypi.douban.com/simple
pip install tornado -i https://pypi.douban.com/simple
pip install twisted -i https://pypi.douban.com/simple
</code></div></pre>
<p><strong>实战演练:安装 FastAPI</strong></p>
<pre><div class="hljs"><code class="lang-shell"><span class="hljs-meta"># </span><span class="language-bash">安装最新版本</span>
pip install fastapi -i https://mirrors.aliyun.com/pypi/simple
<span class="hljs-meta">
# </span><span class="language-bash">安装指定版本</span>
pip install fastapi==0.115.5 -i https://mirrors.aliyun.com/pypi/simple
</code></div></pre>
<h3><a id="24__71"></a>2.4 永久换源</h3>
<h4><a id="241_Linux__73"></a>2.4.1 Linux 配置</h4>
<pre><div class="hljs"><code class="lang-shell">vim ~/.pip/pip.conf # 如果没有就创建
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
</code></div></pre>
<h4><a id="242_Windows__81"></a>2.4.2 Windows 配置</h4>
<p>在目录 <code>C:\Users\Administrator\pip.ini</code> 中创建文件:</p>
<pre><div class="hljs"><code class="lang-shell">[global]
timeout = 6000
index-url = http://pypi.douban.com/simple
trusted-host = pypi.douban.com
</code></div></pre>
<h4><a id="243__92"></a>2.4.3 测试</h4>
<pre><div class="hljs"><code class="lang-shell">pip install fastapi==0.115.5
</code></div></pre>
<h2><a id="3_Whl__98"></a>3 Whl 包安装</h2>
<p>有时候因为网络问题、版本兼容问题,或者某些包在 pip 上下载太慢,可以选择 <strong>下载 <code>.whl</code> 文件(wheel 格式)</strong> 然后离线安装。</p>
<h3><a id="31__whl__102"></a>3.1 什么是 whl 文件?</h3>
<ul>
<li><code>.whl</code> 是 Python 的 <strong>预编译安装包格式</strong>,类似于 Windows 的 <code>.exe</code> 安装程序。</li>
<li>使用 <code>.whl</code> 安装比从源码编译更快,尤其是一些需要编译 C 扩展的库(如 <code>numpy</code>、<code>pandas</code>、<code>lxml</code> 等)。</li>
</ul>
<h3><a id="32_whl__107"></a>3.2 whl 文件下载方式</h3>
<p>可以到以下网站下载对应版本的 <code>.whl</code> 文件:</p>
<ul>
<li><a href="https://pypi.org" target="_blank">PyPI 官方仓库</a></li>
<li>Unofficial Windows Binaries for Python(Windows 常用)</li>
</ul>
<p>下载时需要注意:</p>
<ol>
<li>Python 版本(如 cp37 表示 Python3.7,cp310 表示 Python3.10)</li>
<li>系统架构(如 win32、win_amd64、manylinux 等)</li>
</ol>
<h3><a id="33_whl__119"></a>3.3 whl 文件安装</h3>
<p>进入下载好的 <code>.whl</code> 文件所在目录,使用以下命令安装:</p>
<pre><div class="hljs"><code class="lang-shell"><span class="hljs-meta"># </span><span class="language-bash">例如当前目录有 numpy-1.21.6-cp39-cp39-win_amd64.whl</span>
pip install numpy-1.21.6-cp39-cp39-win_amd64.whl
</code></div></pre>
<p>如果有多个解释器,也可以指定 pip 版本:</p>
<pre><div class="hljs"><code class="lang-shell">pip3.9 install xxx.whl
pip3.10 install xxx.whl
</code></div></pre>
<h2><a id="5__135"></a>5 依赖存储路径</h2>
<p>linux:</p>
<pre><div class="hljs"><code class="lang-shell">./Python-3.8.5/lib/python3.8/site-packages
</code></div></pre>
<p>windows:</p>
<pre><div class="hljs"><code class="lang-shell">C:\Users\Administrator\AppData\Local\Programs\Python\Python38\Lib\site-packages
</code></div></pre>
评论区