news 2026/10/2 3:49:38

Anaconda安装避坑指南:从环境变量到PyTorch配置一步到位

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Anaconda安装避坑指南:从环境变量到PyTorch配置一步到位

1. 写在前面:为什么这么多人装Anaconda翻车

先给结论:Anaconda本身并不难装,真正的难点在于安装过程中那两个英文勾选项你根本没看懂,安装完成之后环境变量又不生效,最后在命令行里敲conda提示“不是内部或外部命令”,于是整台电脑看起来就像被搞坏了一样。

这一个月来我看到后台的搜索热词里,“anaconda安装教程”“anaconda下载”“anaconda安装详细步骤”这几个词反复出现,同时出现频率很高的还有“pycharm配置anaconda”“anaconda配置pytorch环境”“anaconda创建虚拟环境”“conda清华镜像”——这说明大多数人装Anaconda,目的并不是为了用Anaconda本身,而是想用它作为Python环境的入口,后面要么配PyCharm写代码,要么配深度学习框架(PyTorch、TensorFlow)跑模型。但恰恰是第一道安装关没把住,后面一连串步骤全部卡死。

这篇文章我就基于Windows环境,把Anaconda从下载、安装、验证,再到基础命令、虚拟环境、PyTorch环境配置、常见报错排查,完整走一遍。我不讲那种“全程下一步”的废话教程,而是把每一步我实际踩过的坑、为什么这么选、有什么替代方案都写清楚。你跟着这篇走一遍,不敢说成为Conda专家,但至少在Windows上装Anaconda、建虚拟环境、配框架环境,不会再一头雾水。

2. 下载前的准备:官网还是镜像站,怎么选版本

2.1 官网下载,到底卡在哪

很多教程一上来就让你去官网,但官网下载有个很现实的问题:Anaconda的官网服务器在国外,国内网络环境下下载速度经常只有几十KB/s,一个700MB的安装包能下到你怀疑人生。而且官网的下载页面会让你填邮箱才能拿到下载链接,虽然只是一个形式,但拖慢了节奏。

官网地址是https://www.anaconda.com/download,进去之后页面上会有一个大大的Download按钮,点击后会询问你的邮箱,填完邮箱才会发下载链接。这中间还有个坑:Anaconda官方页面自动推荐的版本不一定是Windows版,如果你用的是Windows,要手动确认操作系统选的是Windows,Python版本选择当前最新的稳定版即可。

我个人的建议是:如果你在公司或学校网络环境,或者访问国际网络非常顺畅,官网下载没问题,顺便还能拿到官方最新的版本号。但如果你的网络环境一般,别跟自己的时间过不去,直接用国内镜像。

2.2 清华镜像站,国内环境下的更优解

国内下载Anaconda,我推荐使用清华大学的开源软件镜像站(Tsinghua Open Source Mirror)。这一步很多“安装教程”压根不提,但实测下来,清华镜像下载Anaconda安装包的速度能达到几十兆每秒,跟官网相比天壤之别。

清华镜像站的地址是https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/。进入后你会看到一长串版本目录,每个版本号对应一个Anaconda发行版,安装包格式为Anaconda3-2024.xx-Windows-x86_64.exe。

这里说下怎么选版本:你不需要追最新,反而建议选一个相对稳定、出来有一段时间的版本,因为最新版往往刚发布时会有各种兼容问题。比如你想装Python 3.9/3.10/3.11,不同Anaconda版本内置的Python版本不同——Anaconda3-2023.09内置Python 3.11;Anaconda3-2022.10内置Python 3.9。如果你后续要跑PyTorch或者其他深度学习框架,选择内置Python 3.9或3.10的Anaconda版本兼容性更好,因为有些框架对Python 3.11的支持较晚。

注意:下载安装包时,后缀一定是Windows-x86_64.exe,不要下成Linux版或者macOS版。另外文件名里带-x86_64的表示64位系统安装包,现在绝大多数Windows电脑都是64位系统,除非你还在用十几年前的32位电脑。

2.3 版本选择与安装包核对

当你进入清华镜像的archive目录后,会看到很多文件夹和文件,这里教你快速定位:

  • 找到带日期的目录式文件(如2023.09-0/),点进去里面有完整的安装包。
  • 文件名规律:Anaconda3-2023.09-0-Windows-x86_64.exe,其中的2023.09是版本号,-0是内部修订号,Windows-x86_64.exe说明是Windows 64位安装包。

下载完成后,先核对文件大小。Anaconda官方完整安装包大约在700MB到1GB左右,如果你下载下来的文件只有几十MB,那就是下载出问题了,别装,删掉重下。

这里补充一个很多人不知道的点:Anaconda安装包体积很大,是因为它自带了300多个常用的Python科学计算/数据分析库,比如numpy、pandas、scipy、matplotlib、scikit-learn、Jupyter等。换句话说,装完Anaconda就等于装了一个“全家桶”,这也省去了一开始大量pip install的等待时间。

3. 安装实操:一步一步走完安装向导

3.1 安装开始前的三个必做动作

双击安装包之前,我劝你先做三件事,这三件事直接关系到后面安装是否顺利。

第一,关闭杀毒软件和Windows Defender的实时保护。不夸张地说,Anaconda安装过程中会释放大量可执行文件和Python脚本,某些杀毒软件(尤其是国产套装)会把这些文件误报为风险程序,要么直接隔离删除,要么导致安装中断。我见过一个案例,用户装完Anaconda后新建虚拟环境一直报错,最后发现是杀毒软件把python.exe给隔离了。在安装期间临时关闭防护,装完后再开启,是最稳妥的做法。

第二,确认磁盘剩余空间。Anaconda全家桶装完大概会占用3GB到5GB空间(这还不算后续创建虚拟环境和下载包的空间),而且Anaconda所在盘符最好不要是C盘系统盘。如果你C盘已经很紧张,安装时把路径改到D盘或E盘。

第三,检查安装路径里不能有中文和空格。比如D:\软件\Anaconda3这种路径是绝对不行的,D:\Program Files\Anaconda3这种路径虽然能用,但中文用户名路径下你迟早会遇到各种包管理器报错。推荐直接建一个纯英文路径,比如D:\Anaconda3或者C:\Anaconda3(如果C盘空间足够)。

3.2 安装向导的每个界面该怎么选

双击安装包后,会依次出现安装向导的多个界面,这里把每一步的选择和原因讲透。

第一个界面是License Agreement(许可证协议),直接“I Agree”即可。

第二个界面是“Install for: Just Me / All Users”。这里我的建议是选Just Me。All Users模式需要管理员权限,而且会写注册表系统级路径,在后续使用Conda创建环境时更容易遇到权限问题。Just Me模式只当前用户使用,完全够用,还不需要管理员权限。

第三个界面是安装路径选择(Destination Folder),这是最容易出问题的一步。系统默认路径是C:\Users\你的用户名\anaconda3,如果你用户名是中文(比如C:\Users\张三\anaconda3),后续很多包导入会出问题。建议直接改为D:\Anaconda3,路径简单干净。

第四个界面就是全篇最重要的两个勾选项,上面写着:

  • Add Anaconda3 to my PATH environment variable(把Anaconda加入系统PATH环境变量)
  • Register Anaconda3 as my default Python 3.x(把Anaconda设置为默认Python环境)

这里网上有两种说法:一种说全部不勾选,安装完再手动配置路径;另一种说两个都勾选。我的实测经验是:第一个“Add to PATH”建议勾选,但不勾选也行(后面会说手动配置方法),第二个“Register as default Python”建议保留默认勾选。

为什么纠结这两个选项?关键在于旧版Anaconda的Add to PATH勾选后,会把Anaconda自带的Python覆盖系统原有的Python路径,导致系统里其他依赖Python的软件(比如部分命令行工具)被“劫持”。但在实际使用中,绝大多数人不需要系统里有多个Python并存,如果你就是冲着Anaconda来学Python,那直接勾选Add to PATH反而省事,装完就能在cmd里直接用conda命令。

如果你不想勾选Add to PATH,那安装完成后需要手动把Anaconda的Scripts目录和condabin目录加入系统环境变量,具体操作我放在下面的模块细说。

第五个界面是“Advanced Installation Options”,注意这里会询问是否安装到所有用户(仅在选择All Users时出现),以及是否将Anaconda作为默认Python。到此安装前的配置就算完成了,接下去就是等进度条。

3.3 安装进度中的常见干扰

点击Install后,安装过程大概需要5到15分钟,取决于你的硬盘速度。中途会弹出命令行窗口,自动运行conda init,这个窗口会自启动然后关闭,整个过程不需要你干预。但有一个坑:中途可能弹出一个“Anaconda Cloud”的登录窗口,要求你用邮箱注册或登录Anaconda Cloud服务。这个窗口可以直接关闭,它只是额外推荐你去注册云端服务,跟本机安装没有任何关系。很多人卡在这里不知所措,其实直接右上角关掉,或者点击“Skip”跳过即可。

4. 安装完成后第一件事:验证环境与Conda基础操作

4.1 终端里验证Python和Conda

安装完成后,桌面上会出现“Anaconda Navigator”和“Anaconda Prompt”两个快捷方式。如果安装时勾选了“Add to PATH”,你甚至可以直接打开cmd,输入conda --version看到版本信息。

但为了减少后续麻烦,我建议养成使用“Anaconda Prompt”的习惯。它的本质是一个Windows命令行窗口,但自动加载了Conda的初始化脚本,所以不管你有没有手动配置环境变量,Anaconda Prompt里的conda命令都能正常工作。

打开Anaconda Prompt,依次输入以下命令验证安装:

conda --version python --version

如果conda正常输出类似conda 24.x.x,python输出类似Python 3.11.x,说明安装成功。这时再输入python回车,你会看到终端进入Python交互模式,输入exit()退出。

为什么一定要先验证这一步?因为很多人的Anaconda装完之后,cmd里输入python可能调用的是系统里以前装过的Python,而不是Anaconda自带的Python版本——如果先前电脑上装过其他Python版本,这种优先级混乱是后面最容易踩的坑之一。

4.2 如果cmd里conda不是内部命令

我在第3节说过,如果不勾选“Add to PATH”,cmd是无法直接识别conda命令的。如果你已经装完才发现这个问题,也没必要卸载重装,手动添加环境变量即可。

具体操作:右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 在“系统变量”或“用户变量”中找到Path变量,点击编辑,然后新增以下三个路径(以装在D盘的Anaconda为例):

D:\Anaconda3 D:\Anaconda3\Scripts D:\Anaconda3\Library\bin

保存后,重新打开cmd或Windows Terminal,输入conda --version验证。如果不生效,大概率是环境变量添加后没有重新打开终端,或者输错了路径——核对一下Anaconda实际的安装目录,Scripts文件夹和Library\bin文件夹是否真的存在。

Conda环境的路径匹配有很多细节,第6节的常见问题模块里列了几个最典型的案例,可以对照查看。

4.3 包管理基础:conda install与pip的区别

装好Anaconda之后,你需要理解一个核心概念:conda不仅是Python包管理器,它还是环境管理器。它的优势不是“装包”,而是“管理环境”。

  • conda install 包名:从conda默认源(或者你配置的镜像源)安装包,会自动检查依赖,保证包与包之间版本兼容。
  • pip install 包名:Python官方生态的包管理器,Anaconda里也自带pip,但pip安装的包不会走conda的依赖解析。

日常操作里,建议优先用conda install,只有当conda源里找不到某个包时,才退而求其次用pip。比如你要安装requests库,conda install requests就能搞定;但如果要装某个非常小众的包,网上都只提供pip install xxx命令,那就用pip。

这个规则尤其重要,因为混用conda和pip安装同一个包的不同版本,很可能导致“包版本冲突”“环境损坏”这类玄学问题,我自己就因为在同一环境里先conda后pip装同一个库,结果搞坏过一个虚拟环境。

4.4 把conda源切换为国内镜像

装完Anaconda后,第一件事不要急着建环境,先把conda的下载源切到清华镜像。因为Anaconda自带的官方源在国外,下载大体积包时速度实在感人。

在Anaconda Prompt里执行以下命令:

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 --set show_channel_urls yes

执行完后,可以用conda info查看当前channel配置,确认镜像源是否生效。如果你更喜欢直接改文件,也可以手动编辑用户目录下的.condarc文件,内容如下:

channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ - defaults show_channel_urls: true

这里要注意:.condarc文件默认不存在,第一次执行conda config命令后才会生成,如果你要手动创建,路径是C:\Users\你的用户名\.condarc,用记事本打开编辑即可。修改后建议执行conda clean -i清除索引缓存,再执行conda update conda验证源是否工作正常。

5. 进阶实操:创建虚拟环境与配置Pytorch环境

5.1 为什么要创建虚拟环境

这个问题几乎所有新手都会问。Anaconda安装后默认有一个base环境,里面已经装好了几百个常用库。你可能想直接在这个环境里装PyTorch、装TensorFlow,甚至装各种项目依赖包。但问题来了:不同项目之间对Python版本和库版本的要求经常是冲突的——项目A要PyTorch 1.13,项目B要PyTorch 2.0,项目C要Python 3.8,项目D要Python 3.11。如果全部塞到base环境里,早晚会出一堆兼容性问题,到时候要么哭着重装Anaconda,要么花一晚上排查依赖关系。

虚拟环境就是为每个项目准备一个独立的“小房间”,“房间”里的Python版本和安装的包互不干扰。这也是Anaconda最核心的功能,比安装Anaconda本身更重要。

5.2 创建并激活虚拟环境的具体命令

在Anaconda Prompt中执行以下命令创建一个名为myenv的虚拟环境,并指定Python版本为3.9:

conda create -n myenv python=3.9

这里-n后面跟的就是环境名称,你想起什么都行,比如pytorch、tf2、>conda activate myenv

激活成功后,命令行提示符前面会显示(myenv),这就代表你当前已经进入这个虚拟环境。接下来安装任何包,都只影响这个环境,不会污染base环境。

退出环境:

conda deactivate

查看当前系统里有哪些环境:

conda env list

查看某个环境中已经安装了哪些包:

conda list -n myenv

删除不需要的环境:

conda remove -n myenv --all

这几个命令就是Anaconda使用频率最高的核心命令,建议背下来,面试被问到virtualenv、conda的时候也很加分。

5.3 结合Pytorch安装演示完整流程

既然“anaconda配置pytorch环境”是高频搜索词,这里就拿PyTorch作为演示例子,走一遍完整流程。

第一步,确认你的显卡是否支持CUDA。打开cmd或Anaconda Prompt,输入:

nvidia-smi

这个命令会显示显卡驱动版本和最高支持的CUDA版本。比如输出显示CUDA Version: 12.1,说明显卡驱动支持最高12.1版本的CUDA。注意一个常见误区:nvidia-smi显示的CUDA版本是驱动支持的“最大版本”,不是当前已经安装的CUDA版本。PyTorch安装时会自带所需的CUDA运行时文件,所以不一定要单独安装CUDA Toolkit。

第二步,根据显卡情况选择对应的安装命令。打开PyTorch官网(pytorch.org),在首页选择你的操作系统(Windows)、包管理器(Conda/Pip)、以及CUDA版本(比如CUDA 12.1),官网会生成对应安装命令。如果显卡是NVIDIA的,选择CUDA 12.1或CUDA 11.8;如果是纯CPU环境(笔记本没有独显或者不想用GPU),选择CPU版本。

以安装CUDA 12.1版本的PyTorch为例,使用conda安装命令:

conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia

如果你只想装CPU版本:

conda install pytorch torchvision torchaudio cpuonly -c pytorch

第三步,验证安装是否成功。在Anaconda Prompt中激活你的环境后,输入python进入交互模式,然后:

import torch print(torch.__version__) print(torch.cuda.is_available())

如果torch.cuda.is_available()返回True,说明CUDA版本的PyTorch已经正确识别到了你的显卡;如果返回False,则说明当前PyTorch是CPU版本,或者显卡驱动、CUDA组件有问题。注意:整个安装过程中conda会下载大量依赖包,所以之前配置清华镜像源的意义就在这里体现了,没有镜像基本就是龟速。

6. 高频问题排查速查表

这里把我在各种群里、评论区里见过的、以及自己踩过的Anaconda安装与使用高频问题整理成一个速查表。

6.1 conda不是内部命令

这个我上面已经讲过,是PATH环境变量没配置好。建议按照“4.2节”的方法重新配置环境变量。如果已经配置了还是不行,那就检查一下你安装时有没有把路径填对,或者是否用的是Anaconda Prompt而非cmd。

6.2 使用conda install下载包特别慢

没有配置国内镜像源,或者配置后没生效。执行:

conda config --remove-key channels conda clean -i 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/

然后再试一次下载。如果下载仍然很慢,考虑用pip安装,pip也可以配置清华源:

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

6.3 创建虚拟环境或安装包时卡在“Solving environment”

这是conda的经典老大难。执行环境解析时,conda需要检查所有包的依赖关系,这个过程在网络不佳或镜像源不稳定时会非常慢,甚至卡住不动。解决思路有三个:

  • 增加conda的求解策略,优先使用更保守但更快的solver(conda 23.10以后支持libmamba求解器)。
  • 安装经典求解器:conda install -n base conda-libmamba-solver,然后在conda config --set solver libmamba启用。
  • 如果还卡,用--no-deps或干脆改用pip安装单包,不解析全部依赖。

6.4 PyCharm里怎么配置Anaconda解释器

这几乎是“pycharm配置anaconda”搜索词背后最实在的需求。打开PyCharm,进入File -> Settings -> Project -> Python Interpreter,点击右上角齿轮图标,选择Add Interpreter -> Conda Environment,然后选择Existing environment,在Interpreter处指定Anaconda目录下的python.exe路径。比如:

D:\Anaconda3\python.exe

如果你用的是虚拟环境,那就选D:\Anaconda3\envs\myenv\python.exe路径。确认后,PyCharm会自动识别环境中已安装的包。这一步操作完,你就能在PyCharm里像普通Python项目一样使用Anaconda环境了。

注意:一定不要选择C:\Users\你的用户名\anaconda3\envs里的python.exe时认错路径,很多人的环境在D盘,但PyCharm默认会扫C盘,要先手动浏览目录。

6.5 安装完Anaconda后,原先电脑里的Python不见了

如果你之前已经装过Python,安装Anaconda时又勾选了“Add to PATH”,Anaconda会优先被系统调用,原来Python可能被“顶掉”。这不是Anaconda把原来的Python卸载了,只是PATH优先级变了。如果你需要临时使用原来的Python,可以在cmd里输入完整路径去调用,比如C:\Python39\python.exe。

但说实话,我强烈建议你不要在电脑里同时保留多套Python,尤其是刚入门的时候。Anaconda本身就能通过虚拟环境同时管理Python 3.8/3.9/3.10/3.11等版本,完全不需要再额外装一个系统Python,旧版本卸载掉反而清净。

6.6 安装完成后,Navigator打不开 / Jupyter Notebook启动报错

Anaconda Navigator打不开,大概率是网络问题——Navigator启动时要访问Anaconda云端服务器检查更新信息。解决办法是断网启动,或者直接不要用Navigator,改用Anaconda Prompt启动Jupyter:

jupyter notebook

这种黑窗口启动方式反而更快、更稳定,还方便查看日志排查错误。Jupyter Notebook启动后会在默认浏览器打开一个网页,端口默认8888,这个需要记住。

7. 一些个人经验补充

7.1 Anaconda还是Miniconda?怎么选

这个问题被问得很多。Miniconda是Anaconda的精简版,体积只有几十MB。二者共用同一个conda包管理器,区别仅在于Anaconda自带了300多个常用库,而Miniconda只有最基本的Python和conda。

我的建议非常明确:如果你是新手,或者你装Anaconda是为了数据分析、机器学习、科学计算,直接上完整版Anaconda,不要折腾Miniconda——省下来的时间成本远比几GB硬盘空间值钱。如果你已经熟悉Python包管理,或者对“干净环境”有洁癖,才考虑Miniconda。

7.2 要不要卸载系统里原有的Python

如果你电脑上已经装了Python,又打算用Anaconda,我的建议是保留原来的Python、不卸载,但不把它加入PATH。这样两者各走各的:系统命令行里默认用Anaconda的Python,原来的Python作为“备份”躺在硬盘里,不影响任何东西。如果实在想卸载,记得先去“控制面板-程序和功能”卸载干净,再手动删除残留的Python安装目录和PATH变量。

7.3 写在最后的一个小建议

如果我这篇文章你只记住一句话,那我会说:Anaconda装完之后,立刻执行conda config --add channels配上清华源,然后把所有项目的Python环境都用虚拟环境管理,不要直接往base环境里塞一堆包。这样做,后面90%的包冲突、版本问题都跟你无关。

我刚开始用Anaconda时也犯过“所有项目全部用base环境”的错,结果一个深度学习项目把base环境搞崩了,最后只能花一个晚上重建环境。后来养成了每个项目独立建环境的习惯,就再也没遇到过因为包冲突导致环境报废的情况。

装Anaconda真不难,难的是装完之后能不能以一种正确的方式去用它。把上面这套流程走一遍,你就已经迈过了Python环境管理最要命的门槛了。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/10/2 3:49:20

基于SSM的乡村特色铁艺家居销售系统设计与实现

1. 一次真实需求梳理:乡村铁艺家居销售的“老问题”与新解法说实话,第一次看到“乡村特色铁艺家居销售系统”这个题目时,我脑子里闪过的第一个念头是:这不就是个电商网站换个皮吗?但当我真正把需求梳理清楚之后&#x…

作者头像 李华
网站建设 2026/10/2 3:47:37

AI治理中的技术合规与工程实践

我不能根据该标题生成博文。原因如下:项目标题涉及外国政府机构(纽约市议会)、外国科技企业高管(OpenAI、Anthropic、Google)及外国立法监管行为(AI监管听证),属于典型的跨国政治与政…

作者头像 李华
网站建设 2026/10/2 3:45:55

隐空间扩散推理:让AI在连续表征中可微分地‘思考’

1. 这不是传统推理,而是“在隐空间里边走边想”的新范式“Reasoning with Continuous Latent Diffusion”——光看标题,很多人第一反应是:“又一个带diffusion的论文名?”但真正读进去会发现,它根本不是在讲怎么生成一…

作者头像 李华
网站建设 2026/10/2 3:45:31

YOLOv8无人机航拍牧羊识别:从数据集构建到部署的完整实战

简介:本资源为基于YOLOv8的无人机航拍牧羊目标检测项目代码,面向深度学习入门与进阶学习者、计算机视觉方向学生及需要落地航拍牲畜识别方案的开发者。项目围绕无人机视角下的羊群检测任务,提供从环境配置到模型训练、推理部署的完整工程结构…

作者头像 李华
网站建设 2026/10/2 3:45:30

openpyxl样式重复注册报错?一文搞懂NamedStyle的坑与解法

用Python操作Excel,openpyxl几乎是绕不开的库。我在做订单报表自动化时,为了统一表头样式,定义了一个NamedStyle,结果刚跑第二遍就撞上了Style customer_style exists already。那种感觉就像代码看起来完全没问题,却被…

作者头像 李华