Python pip配置国内镜像源:Windows与Linux永久及临时设置指南

键盘旁的猫
键盘旁的猫
发布时间:2026-10-14| 5人浏览过
原创

本文详细介绍如何在Python中配置国内pip镜像源,包括清华大学、阿里云和豆瓣等推荐源。内容涵盖Windows和Linux平台下的临时使用命令与永久配置文件设置方法,以及常见报错处理,帮助用户加速包下载。

推荐的国内镜像站

个人推荐使用清华大学PyPI镜像站(https://mirrors.tuna.tsinghua.edu.cn/help/pypi/),该源每五分钟同步一次,资源库丰富且下载速度较快。其他可选的国内镜像源包括:清华大学源(https://pypi.tuna.tsinghua.edu.cn/simple)、阿里云源(http://mirrors.aliyun.com/pypi/simple/)以及豆瓣源(http://pypi.douban.com/simple/)。

临时使用国内镜像源进行 pip安装


pip install -i http://pypi.douban.com/simple/ numpy

#如果上一个提示不受信任,就使用这个,此参数“--trusted-host”表示信任
pip install -i http://pypi.douban.com/simple/--trusted-host pypi.douban.com  

永久使用国内镜像源进行 pip安装

1.Windows平台安装方式

在Windows系统中,需进入用户目录,路径通常为 C盘->Users/用户->xxx,并在此目录下新建一个名为 pip 的文件夹。

进入刚才新建的 pip 文件夹,在其中创建一个名为 pip.ini 的配置文件。

打开 pip.ini 文件,并写入以下配置内容(以清华源为例):


[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = https://pypi.tuna.tsinghua.edu.cn  # trusted-host 此参数是为了避免麻烦,否则使用的时候可能会提示不受信任

保存修改后的配置文件后,启动CMD命令行窗口。此时执行 "pip install xxx"(其中xxx为需要下载的包名),系统将默认使用国内镜像源进行下载。

  • #示例:下载Python的numpy库
  • pip install numpy
  • ==》常见报错及解决方法
  • #若执行命令时提示“文件拒绝访问”,通常是因为权限不足,需要以管理员身份运行CMD窗口。
  • #若下载失败,可能是网络拥堵或服务器繁忙导致,可尝试重新输入命令再次执行。

2.Linux平台安装方式

在Linux系统中,首先切换至用户家目录,并创建 .pip 文件夹。


cd ~/.pip
mkdir ~/.pip

进入 .pip 文件夹,并创建名为 pip.conf 的配置文件。


cd ~/.pip
touch pip.conf

在 pip.conf 文件中添加相应的镜像源配置信息。


vi pip.conf
==>(添加信息)
[global] 
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = https://pypi.tuna.tsinghua.edu.cn  # trusted-host 此参数是为了避免麻烦,否则使用的时候可能会提示不受信任

保存并退出文件后,即可正常下载所需资源。

至此,关于Python pip配置国内镜像源的教程介绍完毕。如需了解更多Python pip国内镜像源相关内容,可搜索本站历史文章或继续浏览后续相关文章,感谢支持!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。