ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

Anaconda彻底卸载与重装指南:清除残留、环境变量与注册表

Anaconda彻底卸载与重装指南:清除残留、环境变量与注册表 又有人在群里问 Anaconda 卸载不干净的问题了。这台机器之前装过一版很老的 Anaconda卸载之后conda命令在 CMD 里还能蹦出来python --version显示的是一个 2021 年的旧解释器重新装新版又一直报错说“已经存在”。折腾了半小时最后还是手动把残留的目录、环境变量、注册表一项一项清完才解决。这不算个例。Anaconda 这些年一直是 Python 数据科学领域最常用的发行版但很多人的使用路径是图省事一路默认安装用了一段时间之后发现环境乱了、磁盘满了、或者想换新版才想起卸载。这时候才发现它不像普通软件那样卸载完就干干净净。所以我把从卸载到重装的完整流程整理了出来结合实际操作中的踩坑记录把每一步涉及的文件、命令、界面提示都尽量讲清楚。这篇文章适合三类人装了 Anaconda 想彻底删掉再重装的卸载完之后发现残留太多导致新版装不进去的以及刚接触 Python、想一口气把环境搭好的新手。不管是 Windows 还是 macOS卸载和安装的核心思路都一致文中主要按 Windows 平台展开遇到系统差异的地方我会单独说明。1. 动手之前先搞清楚你到底要做到哪一步1.1 先分清“普通卸载”“彻底卸载”“重装”的区别很多人遇到的问题是“我明明卸载了 Anaconda为什么打开命令行还能用 conda”或者“卸载完之后再安装新版Windows 直接提示 Anaconda 已经存在我就装不回去了。”这些问题的根源在于 Anaconda 的组成比普通软件要复杂。它不只是安装目录里的那堆文件还包括安装目录本身比如C:\Users\你的用户名\anaconda3用户目录下的隐藏配置文件夹.conda、.anaconda等系统环境变量 PATH 中追加的多条路径Windows 注册表中的相关键值开始菜单快捷方式和计划任务其他软件PyCharm、VS Code、Jupyter 服务对这个解释器的引用所以先想清楚场景只是想腾点磁盘空间用官方卸载器卸载就够了但如果你卸载后要重装或者发现命令行里 Python 和 conda 的行为已经错乱就一定要做一次“彻底清理”。本文后续的操作重点放在“彻底清理”上因为重装失败最容易发生在这一步。1.2 卸载前务必做的备份动作我把这一步放在最前面是因为见过太多人卸载到一半才想起里面还有自己辛辛苦苦配好的环境。需要备份的三样东西第一conda 环境列表和包列表。如果你在 base 之外创建过虚拟环境建议先执行导出命令把环境配置保存成文件重装后可以直接用文件重建环境。打开 Anaconda Prompt执行下面这行conda env list确认有哪些环境之后逐个导出conda env export -n 环境名 环境名.yml如果你不记得建过哪些环境也可以直接备份整个envs文件夹。位置通常在你的 Anaconda 安装目录下比如C:\Users\你的用户名\anaconda3\envs整个文件夹复制到其他盘即可。第二conda 源配置文件.condarc。如果你之前手动配置过国内镜像源这个文件非常重要。重装之后没有它可以重新配但提前备份能省去不少事。文件位置在C:\Users\你的用户名\.condarc直接复制备份。第三确认没有正在运行的 Anaconda 相关进程。卸载前要把 Anaconda Prompt、Jupyter Notebook、Spyder、Anaconda Navigator 全部关闭最好顺手把 PyCharm 或 VS Code 也退掉。原因很简单只要还有进程占用安装目录中的文件卸载程序就会跳过一部分文件留下大量无法删除的残留这也是很多“卸载不干净”的直接原因。2. Windows 下彻底卸载 Anaconda一步都别漏2.1 第一步用官方卸载程序卸载Windows 10 和 Windows 11 的路径略有差别但都可以通过“设置”进入。按Win I打开设置进入“应用”-“已安装的应用”在上方的搜索框里输入Anaconda找到条目后点击右侧的卸载按钮按提示确认即可。如果你的系统版本较老也可以从控制面板进入控制面板 - 程序 - 程序和功能找到Anaconda或者Anaconda3右键卸载。这里有两个细节值得注意当初安装时如果选了 “Install for All Users”卸载时会提示需要管理员权限点击“是”就行。官方卸载器结束时可能会弹出一个窗口问你是否要保留配置文件。既然要彻底清理这里选择不保留。卸载过程一般会持续几分钟期间尽量不要让电脑休眠。完成后系统不会自动重启但我会建议你手动重启一次因为环境变量的修改或残留的 DLL 文件占用重启之后才能彻底释放。2.2 第二步清理安装残留目录官方卸载程序只负责删除它认为属于 Anaconda 的“主要文件”用户配置、缓存、Jupyter 数据这些散落在各个位置的目录不会被删除。这也是很多人卸载后磁盘空间没怎么释放的原因。用资源管理器打开以下路径如果存在就手动删除路径中的“你的用户名”替换成你自己的用户名C:\Users\你的用户名\anaconda3 C:\Users\你的用户名\.conda C:\Users\你的用户名\.anaconda C:\Users\你的用户名\.continuum C:\Users\你的用户名\AppData\Roaming\Anaconda C:\Users\你的用户名\AppData\Roaming\Python C:\Users\你的用户名\AppData\Local\anaconda3 C:\ProgramData\Anaconda3这里面绝大多数是隐藏目录。在资源管理器里直接输入路径或者打开“查看”选项卡勾选“隐藏的项目”才能看到它们。有一个判断是否删完的笨方法卸载程序跑完后立刻看一下安装目录是否还在。我遇到过这种情况——卸载程序报“完成”但anaconda3文件夹里还有几百个文件因为python.exe相关的进程一直在后台运行卸载器没权限删除。这时候先打开任务管理器把名字里带 Python、Anaconda、Jupyter 的进程全部结束再回来删除目录。关于AppData\Roaming\Python要额外提醒一句这个目录名下不一定只装着 Anaconda 的内容。如果你还单独装过官方 Python 或某些依赖 Python 的软件它们也可能在这里生成 key 或配置。删之前看一眼如果里面只有 Anaconda 相关的路径就删如果还包含像Python\Scripts这样的其他内容不要仓促处理。2.3 第三步清理环境变量 PATH这是很多人最容易忽略、也最容易出问题的一步。Anaconda 安装时通常会在系统 PATH 中追加以下路径C:\Users\你的用户名\anaconda3 C:\Users\你的用户名\anaconda3\Scripts C:\Users\你的用户名\anaconda3\Library\bin C:\Users\你的用户名\anaconda3\Library\mingw-w64\bin C:\Users\你的用户名\anaconda3\condabin打开环境变量编辑器的方式按Win R输入sysdm.cpl回车在“高级”选项卡里点击“环境变量”。清理的时候一定要分清“用户变量”和“系统变量”两块。Anaconda 默认安装给当前用户时路径通常加在用户变量 PATH 里如果当初选了 All Users则可能加在系统变量 PATH 里。两块都要检查。在 PATH 编辑界面里一项项看只要指向的是 Anaconda 相关的目录就选中后删除。删除完点“确定”保存。这里有一个非常关键的提醒不要为了省事把整个 PATH 删除重建也不要删除那些看起来“报错”的未知路径。PATH 里通常还有 Python 官方路径、Node.js、Git、MySQL 等软件的路径误删会导致那些软件的命令行工具失效。如果你不确定某个路径到底是谁的可以用一个原始但有效的办法把 PATH 里所有路径复制到一个新建的文本文件里备份再逐条删除 Anaconda 相关项。万一后面发现其他软件的命令不可用了打开备份对比一下就知道删错了什么。2.4 第四步检查注册表残留注册表这块要谨慎。很多人一听到“注册表”就觉得像地雷其实没有必要太紧张但确实不能乱删。Anaconda 在卸载后通常还会在注册表里留下启动项和路径记录。如果不去管它们最直接的后果就是重装新版时安装程序会误以为系统里已经存在 Anaconda拒绝继续。按Win R输入regedit打开注册表编辑器主要检查三个位置HKEY_CURRENT_USER\Software\Python HKEY_CURRENT_USER\Software\Anaconda HKEY_LOCAL_MACHINE\SOFTWARE\Python在HKEY_CURRENT_USER\Software\Python里如果能看到ContinuumAnalytics或者公司名相关的子键就直接删除。老版本的 Anaconda 很喜欢在这里建一条InstallPath记录新版安装器检查到这个键就会判断“系统已有旧版本”。只删除和 Anaconda / ContinuumAnalytics 明确相关的键值其他一律不动。有些用户会建议你用注册表编辑器的“查找”功能在全库范围内搜索关键词Anaconda。这个操作能做但非常不推荐毫无经验的人去尝试因为注册表里很多软件的反向域名比如 Python 的包名中都可能包含 “Anaconda” 字样搜出来的结果不一定都该删。宁可少删不可乱删拿不准的就保留重装时如果没报“已经存在”就不用管它。2.5 用检查清单确认卸载干净清理完成后建议按下面的清单逐项确认。不要省略这一步因为很多重装失败是在第二遍安装时才暴露出来的。检查项操作方法预期结果安装目录是否删除打开C:\Users\你的用户名\anaconda3路径不存在用户配置目录是否删除打开C:\Users\你的用户名\.conda路径不存在PATH 是否干净环境变量编辑器里查看用户变量和系统变量看不到 anaconda3 相关路径注册表是否干净regedit 检查 Software\Python无 ContinuumAnalytics 子键命令行是否正常打开 cmd输入conda --version提示找不到 conda 命令开始菜单是否干净打开开始菜单搜索 Anaconda无相关程序入口如果第 5 项在 cmd 里还能执行conda --version说明清理不彻底回到环境变量步骤确认是不是还残留了某个condabin路径或者登录脚本比如 PowerShell 的配置文件里写了激活代码。3. 重新安装 Anaconda从下载到验证3.1 下载安装包官网和镜像站怎么选Anaconda 的官网下载地址是https://www.anaconda.com/download页面会自动检测操作系统但偶尔会识别错建议手动选择 Windows、macOS 或 Linux 标签页。下载页面里有两个选择要特别注意Python 版本Anaconda 会捆绑一个默认的 Python 版本例如 3.11 或 3.12。选新不选旧不是绝对原则但如果你后续要装 PyTorch、TensorFlow 之类的框架先确认对应的版本兼容性一般选最新的稳定版问题不大。系统架构现在的电脑绝大多数是 64 位直接选 64-Bit 版本。如果拿不准右键“此电脑”-“属性”里可以看到系统类型。如果你在内地网络环境下从官网下载安装包的速度会不太理想这时可以用国内镜像站代替过程完全一样。先把安装包下载到本地再手动双击安装即可。常用的镜像站有清华 TUNA进入 Anaconda 镜像目录后选archive/目录按版本号下载.exe文件即可。3.2 安装过程中每个选项都别太着急下载完成后双击安装包进入安装向导。大部分选项用默认的没问题但下面这几个地方值得停下来仔细看一眼。第一个是 “Install for” 的选择。推荐选 “Just Me”仅当前用户。选 “All Users” 意味着安装到C:\ProgramData\Anaconda3后续创建环境、安装包都需要管理员权限很多软件调用时会遇到权限弹窗没必要给自己找麻烦。第二个是安装路径。默认路径一般是C:\Users\你的用户名\anaconda3建议沿用默认或者手动改成纯英文、无空格的路径比如D:\Anaconda3。千万不要出现中文字符或空格否则后续 conda 创建虚拟环境、安装某些依赖 C 库的包时很可能会因为路径编码问题报错。第三个是高级选项也是很多人疑惑最多的地方[ ] Add Anaconda3 to my PATH environment variable [ ] Register Anaconda3 as my default Python第一项“添加 Anaconda 到 PATH”安装器默认是不勾选的。如果你不是特别清楚这个选项的副作用我建议勾选上。很多新手第一次用 Anaconda打开 cmd 输入conda却提示找不到命令就是这个选项没勾。但要注意勾选它会导致系统里的python命令指向 Anaconda 的 Python如果你电脑里还装了其他版本的 Python比如从 python.org 安装的可能会产生冲突。第二项“注册为默认 Python”同样建议勾选。它会让 Anaconda 的 Python 成为系统默认解释器PyCharm、VS Code 等 IDE 在自动识别 Python 解释器时会优先找到它。如果你已经有其他 Python 环境还想要 Anaconda可以不勾但那样以后每次都要手动选择解释器对新手不太友好。点击 “Install” 后进入安装过程等待进度条走完。中途如果提示“Error: Unable to find…”一般是上一步卸载残留的问题回到第 2 节重新清理重点看注册表和环境变量。3.3 安装完成后的第一眼验证安装完成后开始菜单会出现 “Anaconda Navigator”、“Anaconda Prompt”、“Jupyter Notebook”、“Spyder” 几个入口。先不要急着打开 Anaconda Navigator。我习惯先打开 Anaconda Prompt依次输入下面三个命令conda --version python --version conda info如果都能正常输出版本信息说明安装成功。其中conda info会显示当前 conda 版本、Python 版本、环境路径等一眼就能确认进程是否正常。再打开 Anaconda Navigator看能否正常进入主界面。第一次打开时会加载一段时间这属于正常现象等它初始化完就行。如果卡在启动界面超过十几分钟先重启试试还不行就检查安装路径是否有中文或者尝试用管理员身份运行。4. 重装不是终点后续配置这一节别跳4.1 换国内镜像源让安装包速度回到正常水平Anaconda 自带的官方源服务器在国外安装包从官网下载慢可以理解但 conda 安装包时也慢就让人很头疼了。换源是最立竿见影的优化操作。打开 Anaconda Prompt先执行一次conda config --set show_channel_urls yes然后打开用户目录下新生成的.condarc文件路径在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/cloud/conda-forge/ show_channel_urls: true ssl_verify: true保存后执行conda info再确认 channel 是否生效。以后安装包、创建环境的速度会有质的提升。顺手把 pip 源也一起换了省得以后pip install再踩一次坑pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple4.2 虚拟环境怎么建才不至于把 base 弄成一锅粥很多人在新装好的 Anaconda 里第一件事就是pip install xxx往 base 环境里堆包。短期内看着没问题一旦装了几十个包之后依赖冲突、版本不兼容就全来了。到时候想排查是哪次安装把环境搞坏的几乎不可能。所以重装之后我建议立刻养成一个习惯为每个项目单独创建虚拟环境。比如想搭一个 PyTorch 环境conda create -n pytorch python3.11创建完成后激活conda activate pytorch看到命令行前面出现(pytorch)前缀就说明已经进入这个环境了之后用 pip 或 conda 安装的包都会装进这个环境不影响 base。退出环境用conda deactivate一些常用的 conda 命令在这里一起列出来收藏当速查表用需求命令查看所有环境conda env list创建环境conda create -n 环境名 python3.11激活环境conda activate 环境名退出环境conda deactivate删除环境conda remove -n 环境名 --all查看当前环境包列表conda list搜索包版本conda search 包名安装包conda install 包名导出环境配置conda env export -n 环境名 环境名.yml从配置生成环境conda env create -f 环境名.yml建好环境后如果要让 PyCharm 使用这个新环境在设置里找到 Python 解释器选择Conda 环境然后指定 Anaconda 路径下的python.exe比如C:\Users\你的用户名\anaconda3\envs\pytorch\python.exePyCharm 会自动识别环境中已安装的包。5. 卸载和安装过程中的常见坑与排查办法5.1 高频问题速查表我把实际操作中最常碰到的问题列成了一张表按症状、原因、解决方式排列遇到问题可以直接对照查。常见现象可能的原因解决方案卸载后 cmd 里conda仍可用PATH 环境变量未清理或当前终端窗口还缓存着旧路径检查用户变量和系统变量删除 Anaconda 相关项重新打开 cmd重装时提示已存在 Anaconda注册表残留ContinuumAnalytics键按 2.4 节清理注册表重点检查 HKCU\Software\Python安装完成后conda不是内部或外部命令安装时未勾选“添加 Anaconda 到 PATH”手动在 PATH 中添加 anaconda3、Scripts、Library\bin 等路径或重新运行安装器勾选该选项打开 Anaconda Navigator 一直转圈首次启动需要初始化或网络问题导致组件加载失败等 10 分钟以上重启软件检查源配置是否正确创建环境时报网络错误conda 源连接超时或源被卡住换镜像源执行conda clean -i后重试也可以切换网络环境试试激活环境时提示 “This Python interpreter is in a conda environment but the environment has not been activated”在未激活 conda 环境下直接调用了某环境中的 python.exe先执行conda activate 环境名或者检查 IDE 中是否选中目标环境卸载后磁盘空间没怎么释放用户目录下的.conda、AppData缓存未清理或卸载时有进程占用按 2.2 节手动删除残留目录用任务管理器结束 Python/Jupyter 相关进程后再删5.2 一些容易被忽略的小细节最后分享几个实测中容易踩到但很少被写进教程的细节。第一重装完不要立刻假装手速很快先重启一次终端。很多人在安装完成后还开着旧的 CMD 窗口输入conda --version报“不是内部或外部命令”以为自己装坏了。其实新的环境变量需要在新的终端窗口才能加载重启一下终端就能解决不用急着重装。第二如果卸载完发现python命令还是能运行但where python输出的路径已经不存在说明系统里还有其他软件引用了 Python也可能是某些 PNG 脚本或者计划任务在调用。这一步处理要谨慎不要删除这些引用本身只需要确认 CMD 执行python时首先找到的是哪个路径即可。第三安装路径永远不要用中文。这句话我说了多少遍都觉得不够。Anaconda 路径里只要出现一个中文字符轻则pip install编译报错重则整个环境初始化失败直接在安装阶段就卡爆。动手前找一个纯英文路径能省掉后面一整天的排查时间。第四如果你有使用 Anaconda 的老项目重建环境时不要无脑conda env create -f。导出文件里会包含当前机器的具体路径换机器或换用户后经常出现路径对不上的问题。遇到报错时把.yml文件里的- prefix:那行删掉再执行创建命令基本都能解决。Anaconda 的安装与卸载本质上就是一条“配置隔离”的路。装的时候给 Python 一个干净的家卸载的时候把这个家拆干净别让它给其他软件留一堆看不见的坑。希望这篇图文几步走的总结能帮你少走几次弯路。
返回列表