☰
Anaconda下载慢?用清华镜像配置conda和pip源,从安装到环境管理全流程实操
2026/10/2 19:12:12 网站建设 项目流程

搞Python开发的人,对Anaconda应该不陌生。它自带conda包管理器和一整套科学计算库,装一次就能把Python环境、Jupyter Notebook、常用数据分析库全部配齐,非常适合做数据科学、机器学习和脚本开发的人用。但很多新手的第一次Anaconda体验,都卡在下载安装这一步:官方服务器的安装包体积动辄几百MB,本地网络环境下访问速度很不稳定,经常下一半就断。针对这个情况,用清华开源软件镜像站来下载和配置,是大家用得最多、也最稳妥的一套方案。这篇文章就用完整的实操流程,把Anaconda搭配清华镜像的下载、安装、配置、使用全部过一遍,适合刚接触Python的小白,也适合被源问题困扰、想换个干净方案的老人。

1. 内容整体设计与思路拆解

1.1 核心需求:下载慢的根源与镜像方案

先说清楚一个问题:Anaconda盘点分布广,为什么一定要用清华镜像?

Anaconda的默认软件源部署在官方服务器上,安装包、conda源、pip源全部指向海外节点。在本地网络环境下,访问这类海外服务器的延迟和带宽波动都很明显,尤其是一个600MB到1GB的Anaconda安装包,从官方渠道下载经常出现“速度掉到几十KB/s”“下到一半连接重置”这类问题。这不只是耐心问题,更可能因为文件不完整导致安装失败,或者下载的exe包哈希校验不通过,双击之后安装器直接报错。

清华镜像站的全称是清华开源软件镜像站,它做的事情就是把Anaconda仓库的安装包、conda源、pip源定期同步到自己的服务器上。你可以把它理解成官方仓库的一个“本地副本”,就像网购的包裹先运到你家附近的中转站,再取货就快得多。配好清华镜像之后,conda install和pip install请求全部走清华的节点,速度通常能达到几MB/s甚至更高,体验差距非常明显。

这篇博文的整体思路很直接:先解决“装得上”的问题,再解决“装得快”的问题,最后解决“用得顺”的问题。安装包从清华镜像的archive目录下载,conda源和pip源都配成清华的镜像地址,然后基于Anaconda自带的虚拟环境功能管理项目依赖。这样一套下来,等于把整个Python生态环境的下载环节都迁到了本地节点,之后无论建新环境还是装新包,都不太会遇到卡下载的问题。

1.2 方案选型:Anaconda、Miniconda与镜像下载怎么选

很多人第一次接触会把Anaconda和Miniconda搞混,这里先给一个简单的对比:

项目AnacondaMiniconda
安装包体积较大,通常600MB以上很小,80MB左右
预装内容自带Python、conda以及300多个常用科学计算包只带Python、conda和少量基础包
适用场景新手、数据分析、机器学习,开箱即用想自己掌控环境、节省磁盘空间的人
包管理能力conda + pip都能用conda + pip都能用

如果你主要做数据处理、机器学习,或者刚入门Python,用Anaconda最省事,因为它把NumPy、Pandas、Matplotlib这些常用的库都预装好了,装完打开Jupyter就能用。如果你是个老手,或者只是需要在一个空环境里跑项目,Miniconda更轻量,后续需要什么包再装什么包,环境更干净。

下载渠道方面,安装包推荐直接走清华镜像的Anaconda archive目录,这里保留了各历史版本的安装包,下载速度比官方稳很多,而且文件名里带有完整的版本号,方便你选择。安装包下载完之后,剩下的conda源、pip源配置也在清华镜像上操作,整体方案保持统一,管理起来不绕。

2. 核心细节解析与实操要点

2.1 安装包下载与版本选择要点

清华镜像的Anaconda安装包路径是这个:

https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/

打开后你会看到一长串文件,命名大概长这样:

Anaconda3-2024.02-1-Windows-x86_64.exe Anaconda3-2024.06-1-Linux-x86_64.sh Anaconda3-2024.02-1-MacOSX-arm64.pkg

文件名里的关键信息有三个。第一是版本号,比如2024.02,这个代表Anaconda的发行版本,新版通常会更新内置的Python版本和预装包。第二是平台,Windows、Linux、MacOSX分别对应不同系统。第三是架构,x86_64是64位,arm64是苹果M系列芯片或者部分ARM设备用的。

选版本的时候我的建议是:不要盲目追最新。你可以在官网的Release Notes里看一下每个版本对应的Anaconda内置Python版本,确认它能覆盖你项目需要的最低Python版本再下手。如果只是本地学Python、做数据分析,选归档目录里比较新的稳定版即可;如果是生产环境或者配合公司老项目,优先找对应Python版本的Anaconda,比如内置Python 3.8或3.9的版本,避免后面遇到依赖不兼容的问题。

Windows系统下一定要确认下载的是x86_64版本。现在绝大多数电脑都是64位系统,如果你不小心下到了32位版本,后面安装某些科学计算包时会遇到“只能支持64位”的报错。下载完成后如果担心文件损坏,可以在终端工具里校验一下SHA256,清华镜像的archive目录里通常附带校验值,这个步骤虽然麻烦一点,但对稳定安装很有帮助。

2.2 conda源配置原理:.condarc与channel优先级

conda源配置的本质是修改一个配置文件,这个文件叫.condarc。它的默认位置在不同系统上不一样,Windows一般是在用户目录下,Linux和macOS是在~/.condarc。

.condarc里有一个关键字段叫channels,它定义的是conda去哪些仓库里搜索包。很多人以为channels随便加一个就行,其实里面有一个重要规则:顺序决定优先级。排在前面的channel会被优先搜索,排在后面的作为补充。比如你把conda-forge放在最前面,那conda在安装包时会优先从conda-forge拉取,如果把清华的main放在前面,则优先从主仓库拉取。

清华镜像目前可用的conda channel主要有这些:

https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/ https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda/ https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/

其中main是Anaconda官方的主仓库,大多数常用包都能在这里找到;free是早期仓库的遗留,很多包已经移到main里了,但旧环境可能还需要;conda-forge是社区维护的大仓库,包更新更快、覆盖面更广;bioconda偏生物信息领域;pytorch是PyTorch相关的channel。

配置的时候不要把一堆channel全塞进去。我的经验是,日常使用配main就够了,需要conda-forge的包时再单独加,或者干脆按项目需要临时指定channel。channel加得越多,依赖解析越慢,而且有时候不同channel里的同一包版本不一致,会引发依赖冲突,排查起来很头疼。

2.3 pip源为什么也要单独配置

很多新手会有个疑问:既然conda都配了清华镜像,为什么还要配pip?

原因是conda和pip是两套独立的包管理系统。conda不仅管Python包,还管底层依赖库、运行时甚至非Python的库;pip则纯粹是Python包管理器。Anaconda里虽然预装了很多包,但日常用pip安装PyPI上的Python包依然非常频繁,比如一些只在PyPI发布、没有进入conda渠道的库。pip如果不单独配源,它下载时走的还是PyPI官方地址,同样会卡在下载上。

清华镜像也提供了PyPI源的同步,配置命令很简单:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

这个命令会帮你写好一个pip配置文件,之后所有pip install默认走清华的PyPI镜像。如果不想永久修改,也可以临时指定:

pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple

我推荐永久配置的方式,一劳永逸。两条路径都配上,conda和pip就不会再出现一个快一个慢的割裂状态。

3. 实操过程与核心环节实现

3.1 Windows下Anaconda安装完整步骤

整套实操从零开始,我先以Windows平台为例子,Linux和macOS的流程类似,后面会提需要注意的差异。

第一步,打开清华镜像的archive目录,找到Anaconda3-2024.02-1-Windows-x86_64.exe这一类的安装包下载。建议存到一个不带中文路径的目录,方便后面命令行操作。

第二步,双击安装包。安装向导会连续问你几个问题,最需要注意的是这两个:

  • 安装类型:建议选“Just Me”,不要选“All Users”。后者需要管理员权限,而且安装后权限管理更麻烦,对个人使用来说纯属给自己添堵。
  • 目标目录:默认是C盘用户目录下的Anaconda3。如果你C盘空间紧张,可以改到D盘,比如D:\Anaconda3,但目录路径不要带空格,也不要带中文,后续很多工具在带空格的路径下容易出问题。

第三步,出现Advanced Options时,建议勾选“Add Anaconda3 to my PATH environment variable”。新版Anaconda安装器默认不勾这一项,如果你不勾,装完后在cmd里输入conda会提示找不到命令,只能通过开始菜单里的Anaconda Prompt进入环境。把Anaconda加入PATH之后,cmd和PowerShell里就能直接使用conda命令,更符合平时的使用习惯。

第四步,等待安装进程走完。安装过程中不建议做其他重负载操作,避免写入文件时出现权限冲突。安装完成后,安装器会提示你是否安装VS Code,这个按需选择,不需要可以直接跳过。

第五步,打开一个新的cmd窗口,分别执行两条命令验证安装结果:

conda --version python --version

如果能看到conda的版本号和Python版本号,说明安装成功,并且PATH也生效了。如果发现python命令不可用,先检查一下是不是开了旧终端窗口,新窗口重新打开再看,通常就是PATH没刷新。

Linux和macOS用户装的则是.sh或.pkg文件。.sh文件下载后需要先给执行权限,再运行:bash Anaconda3-*.sh。安装过程中会有添加PATH的提示,记得选yes。macOS的.pkg文件直接双击安装即可,不过国产Intel芯片和Apple Silicon的包不要下错,arm64和x86_64的包不通用。

3.2 清华镜像源配置三步走

Anaconda装好后,第一时间配置清华镜像。全部操作就三步,第一配置conda channels,第二验证配置,第三配置pip源。

打开cmd,执行下面这段命令,逐行粘贴过去:

conda config --set show_channel_urls yes conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ conda config --set show_channel_urls yes

第一行的作用是让conda在安装包时显示来源channel,方便你后续观察包从哪个地址下载。第二到第五行是按从后往前的顺序添加channel的,所以执行完之后,最后添加的conda-forge会在最前面。这里有一个需要注意的问题:如果你希望main仓库优先级最高,其实顺序会有偏差,因为conda config的add操作是把新channel插到最前面。

所以更推荐的做法是执行完上面命令后,直接打开C:\Users\你的用户名\.condarc文件,手动调整成下面的顺序再保存:

channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/ - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ show_channel_urls: true

保存之后,执行:

conda clean -i

这个命令会清理掉之前缓存的索引和包数据,避免旧索引残留影响新源生效。接着验证当前通道配置:

conda config --show channels

最后配置pip源:

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

配置完之后,建议顺手做一次“实测”。比如安装一个常用的requests库:

pip install requests

注意观察输出里有没有出现pypi.tuna.tsinghua.edu.cn的地址。如果出现,说明pip镜像已经生效;如果还是pypi.org,检查一下pip的版本以及配置文件路径是否设置成功。

3.3 用虚拟环境管理项目依赖

Anaconda配好源之后,最值得养成的习惯就是使用虚拟环境。虚拟环境的核心作用是把不同项目的依赖包隔离开。比如项目A需要Pandas 1.5,项目B需要Pandas 2.0,如果装在一个全局环境里,升级一个就会破坏另一个。用虚拟环境,各用各的,互不干扰。

创建虚拟环境的命令:

conda create -n myenv python=3.10

-n myenv表示环境名,python=3.10表示创建时使用Python 3.10版本。执行后conda会去清华源拉取对应的Python包,速度正常情况下很快。它会询问是否继续安装,输入y即可。

激活环境:

conda activate myenv

激活后终端提示符前面会多一个(myenv),这就是环境切换成功的标志。之后输入python用的就是环境里的Python解释器,pip install的包也会装到这个环境里,而不是全局环境。

在环境里安装包:

conda install numpy pandas matplotlib

或者如果你要装的是PyPI上的包:

pip install flask

查看当前有哪些环境:

conda env list

退出当前环境:

conda deactivate

删除环境:

conda remove -n myenv --all

导出当前环境的依赖清单,方便别人复现你的运行环境:

conda env export > environment.yml

别人拿到这个文件后,用conda env create -f environment.yml就能重建出一个一样的Python环境。这个操作在发布开源项目、团队协作时特别实用,强烈建议养成习惯。

3.4 常见场景:在Anaconda里配置PyTorch环境

镜像配好后,大多数人会遇到的一个高频需求就是配置PyTorch环境。这里单独拿出来说一下。

创建一个专门的环境:

conda create -n pytorch python=3.10 conda activate pytorch

如果直接用conda安装PyTorch,需要先添加清华镜像的pytorch channel:

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/

然后执行:

conda install pytorch torchvision torchaudio

但这里我要多说一句:PyTorch的conda安装包在不同平台上有不同版本的区分,尤其是CPU版和GPU版。如果你的电脑没有独立NVIDIA显卡,或者暂时不需要GPU加速,建议直接走pip安装CPU版,体积小,也不用配CUDA相关依赖:

pip install torch torchvision torchaudio

如果要用GPU版,先确认自己的显卡、驱动和CUDA版本,再按官网的命令安装,一般会用到类似--index-url https://download.pytorch.org/whl/cu118这样的地址。这里优先建议走官网的PyTorch安装命令生成页,因为它会把CUDA版本和Python版本匹配好,比自己手动拼参数稳得多。

4. 常见问题与排查技巧实录

4.1 安装阶段高频问题

安装完成后conda命令找不到

最典型的就是安装时没勾选“Add Anaconda3 to my PATH environment variable”。处理方式有两种:一是打开Anaconda Prompt使用,二是手动把C:\Users\你的用户名\Anaconda3和C:\Users\你的用户名\Anaconda3\Scripts这两个路径加到系统环境变量Path里。加完之后重开cmd窗口,再试conda --version。

安装包下载到一半失败

这个大多是网络不稳定导致的,不要在浏览器里挂着等,直接换成清华镜像的archive目录下载,成功率会高很多。如果再失败,可以用支持断点续传的下载工具拉取,下完比对校验值。

安装器提示Python版本不支持

有些老项目或者旧版本工具对Python版本敏感,Anaconda新版内置的Python版本太新可能导致部分包不兼容。这时去清华镜像archive目录里找历史版本,比如内置Python 3.8或3.9的Anaconda版本,专门建一个环境配合老项目。

4.2 配置镜像后遇到的问题

CondaHTTPError: SSL certificate verify failed

这个报错通常出现在网络环境有HTTPS证书拦截,或者系统时间不对导致证书校验失败。先同步系统时间,再试试更新conda的ca-certificates包。实在不行可以用conda config --set ssl_verify false临时关闭校验,但不建议长期开着,有安全风险。

PackageNotFoundError

出现这个报错,首先确认包名写没写错,其次确认当前channel里是否真的包含这个包。比如有些包只在conda-forge里发布,而你没有把这个channel加进去。处理方式很直接:临时指定channel安装。

conda install -c conda-forge 包名

conda一直卡在“Solving environment”

在conda 4.x版本里,依赖解析慢是个老问题。配置清华镜像后通常会缓解网络等待,但如果某次安装需要解析大量依赖,还是会卡几分钟。我的经验是:尽量把依赖拆小安装,一次少装几个包;或者升级到较新的conda版本,新版解析策略快很多。另外也可以等待它跑完,不要频繁Ctrl+C,否则容易破坏环境。

pip install还是走官方源

检查一下pip配置是否真的生效,执行pip config list看看global.index-url是否已设置。如果设置了但还是走官方,可能是因为命令执行环境不是同一个Python环境。在conda激活的环境里,再执行一遍pip config set即可。

4.3 避坑经验清单

最后分享几条我用Anaconda和清华镜像过程中实际踩出来的经验,不一定写在官方文档里,但很管用。

第一,不要把conda的channel加得太杂。有些教程让你一次性把main、free、r、conda-forge、bioconda全加进去,看起来“包罗万象”,实际使用中经常出现版本冲突。日常环境只保留main和conda-forge就够了,遇到具体的包再临时指定channel,干净又好排查。

第二,conda和pip混用要谨慎。conda管理的包,尽量不要再用pip去覆盖安装同一个包,容易造成环境元数据混乱。如果某个包只能用pip装,就先conda install pip确保pip是最新版本,再进环境用pip安装。

第三,升级Anaconda一定要备份环境。执行conda update --all之前,最好先把环境导出成.yml文件,因为大版本更新偶尔会把某些包升级到不兼容版本,到时候想回退很麻烦。

第四,清华镜像的同步是有延迟的。有时候你在官方源刚发布的新包,镜像站可能还没同步过来,刚好赶上这种时间窗口,慢几个小时或者一天是正常的。除非是极紧急的情况,否则不需要反复操作换源,等同步完成即可。

第五,不要频繁执行conda clean --all里的某些选项。清理索引和缓存虽然能释放空间,但会把已下载的安装包也清掉,下次安装同一个包又得重新下载,反而更慢。清理前看清楚每个选项的含义,只清理你确实不需要的部分。

最后再多说一句

这整套流程我前前后后给不少同事和学员配置过,印象最深的事情是:很多人第一次配好镜像之后,再创建环境、安装包,速度从“一首歌都下不完”变成“几秒钟就装好”,那种体验上的反差确实很直观。其实Anaconda本身只是一个工具,真正让工作流顺畅起来的,往往是这类“把基础环境调稳”的小事。花十分钟把源配好,后面每一次安装包、每一次建环境都会受益。如果你装完之后还有时间,建议顺手把Jupyter打开试一下,创建一个新notebook,跑一段简单的Pandas代码,确认整套环境是通的,这样后续用起来会更踏实。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询