ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Anaconda+PyCharm配置全攻略:2023最新版环境搭建与常见报错解决

2026/9/30 3:51:54 拓冰建站 浏览量
Anaconda+PyCharm配置全攻略:2023最新版环境搭建与常见报错解决 先用最直白的话说结论2023年这个时间点如果你要开始正经搞Python开发Anaconda PyCharm这套组合依然是新手最稳的上车方式没有之一。Anaconda负责把你电脑里的Python环境、第三方库、虚拟环境管理得干干净净PyCharm负责让你写代码、跑脚本、调试报错时不会想砸电脑。网上说这俩的文章多到爆炸但大部分要么是纯截图流水账要么是版本旧得连安装界面都对不上。我这篇就基于2023版的安装包从下载选版到解释器配置再到日常最常见的报错一条路走完顺便把每一步为什么这么做讲清楚——很多事情你知道了原理后面十年都不会再被类似问题卡住。1. 为什么是Anaconda PyCharm这套组合在帮你解决什么很多刚接触Python的人会有个错觉学Python就是学语法装个解释器就完事了。等真上手写项目才发现环境这块才是劝退大户。1.1 拦在入门路上的三个基础问题先拆开看。Python本身是一套解释器但实际开发时你的电脑里往往不止一个Python。你今天跑了爬虫需要requests明天做数据分析又需要pandas、numpy后天试个深度学习框架又要求Python版本不能高于3.10。如果全程裸装最典型的结局就是卸载重装了一个Python版本结果之前装好的包全没了或者某个包强制依赖A库的2.x版本另一个包点名要A库的1.x版本两个放一起直接冲突。第二个问题是包安装的通道太脆弱。裸Python用pip装包默认从官方PyPI下载慢不说经常超时。等你学会切换国内镜像源又会发现每次重装系统后这些配置都得再来一遍。第三个问题是IDE和解释器的关系没弄明白。很多人以为装完PyCharm就能直接跑Python一看提示找不到解释器就懵。其实PyCharm只是个编辑器它需要明确指定用哪个Python程序来执行代码这个指定的动作就是大家常说的解释器配置。1.2 Anaconda把前两个问题一揽子搞定了Anaconda本质上是一个Python发行版它自带了一个Python解释器2023版Anaconda默认内置Python 3.11同时集成了conda这个包管理和环境管理工具还预装了两百多个常用科学计算和数据处理的库。这相当于你不需要一个个去 pip install 那些最常见的库装了Anaconda打开就能用在pandas、numpy、matplotlib上。更重要的是conda的虚拟环境能力你可以用一条命令创建一个完全隔离的Python环境指定版本、指定装什么包这个环境里的东西跟系统里其他环境互不干扰。搞坏了也不用慌删掉重建就是代价基本为零。1.3 PyCharm解决的是写代码效率和排错体验的问题PyCharm是JetBrains家的Python IDE社区版是免费开源的。它的价值在于代码自动补全、实时的语法检查、快捷键操作、断点调试、内置终端。其中断点调试这个功能对新手尤其救命——你写了个循环结果不对在可疑行打个断点逐行看变量变化问题基本一眼定位。为什么不推荐用文本编辑器加命令行替代不是不行而是心智负担太重。你同时要记项目结构、包导入关系、命令行参数还得肉眼找代码错误。PyCharm把这些可视化之后新手可以把更多认知资源留给逻辑本身。这也是为什么教程普遍建议用Anaconda管理环境、用PyChorm写代码两者通过指定解释器路径打通之后协同成本非常低。2. 下载前的版本决策2023版要怎么选才不至于推倒重来安装失败、装完不能用的案例里相当大比例是下载阶段就选错了东西。2023年的Anaconda和PyCharm版本虽然安装界面已经相当友好但版本选择和下载来源还是有讲究的。2.1 Anaconda 2023版的安装包命名规则以2023年9月发布的Anaconda 2023.09-0为例下载页面里会提供多个安装包。Windows平台认准Anaconda3-2023.09-0-Windows-x86_64.exe就行现在的个人电脑基本全是64位系统那些x86_32位的安装包不用管那是给老古董32位系统用的。macOS平台这里是2023年特别容易踩坑的点如果你的Mac是M1/M2芯片要下载macOS-arm64结尾的安装包如果是Intel芯片的老Mac才选macOS-x86_64。2023年Apple Silicon的机器已经非常普遍了哪怕是二手市场买的老款M1也不在少数。很多人看到arm64以为是新架构会不兼容犹豫一下选了x86_64版本结果在M芯片上安装后PyCharm导入解释器时各种异常排查半天才发现是安装包跟CPU架构不匹配。这点我真是见过太多人犯了一定要对号入座。Linux平台相对简单下载.sh脚本文件终端运行bash Anaconda3-2023.09-0-Linux-x86_64.sh即可但要注意服务器最小化安装缺少依赖时可能要先yum install -y bzip2之类的。2.2 PyCharm社区版还是专业版看这几件事再决定PyCharm分为Community社区版免费和Professional专业版付费订阅。大多数学习Python和做数据分析、爬虫、Web开发初期的用户社区版完全够用。这里用表格把差异要点列出对比维度社区版Community专业版Professional费用免费付费订阅Python核心开发、代码补全、调试支持支持前端/HTML/CSS/JavaScript支持基础支持且有限完整支持Django、Flask等Web框架支持不完整或缺失完整支持数据库工具、远程部署不支持支持常见使用人群学习、数据分析、脚本开发全栈Web开发、企业项目以2023年的功能划分来看我个人的建议是你只要不确定自己用不用得上专业版的功能就直接用社区版先跑起来等哪天明确要做Django项目了再换专业版也不迟。毕竟专业版如果要激活使用涉及商业授权费用学生可以申请教育免费授权但新手阶段真的没必要折腾这些。2.3 下载渠道怎么选官网优先镜像兜底Anaconda官网的下载服务器在国外国内直连经常一个几百MB的安装包下得断断续续。2023年版安装包体积大约1GB左右官网下载体验确实不够顺畅。推荐的办法是优先打开Anaconda官网选择对应的安装包然后用国内高校镜像站的下载链接替代实际下载地址。清华大学开源软件镜像站mirrors.tuna.tsinghua.edu.cn/anaconda/archive/会同步所有版本的安装包国内速度要快非常多。你需要做的只是先到官网确认你要的版本号再去镜像站找到对应文件名的安装包下载即可。那里有几个子目录archive/目录里存的就是全部历史版本的安装文件。PyCharm官方下载地址是JetBrains官网国内访问速度尚可社区版页面直接下载。同样不推荐去什么软件站下载那些站点经常捆绑安装各种全家桶或者给你一个改过的安装包得不偿失。3. Anaconda安装实操从双击到conda --version这节我们直接走完整流程所有选项都给到位并解释每个关键选项在2023版里到底意味着什么。3.1 Windows安装过程的选项怎么勾双击Anaconda3-2023.09-0-Windows-x86_64.exe之后一路Next到选择安装路径。这里第一坑出现了千万不要装在系统盘C盘默认路径尤其不建议路径里有中文或空格比如D:\Study\Anaconda3就很好。后续你创建conda环境、安装包都会占用大量空间装在C盘后面系统盘红了会很痛苦路径里有中文或空格个别库在编译原生的扩展时会解析出错这类问题极难排查。第二坑在Installation Type这一步2023版安装界面默认选项其实发生过变化。官方默认是Just Me仅当前用户安装这个选择没问题不要选All Users因为All Users模式在Windows下经常出现权限不足的报错尤其是公司电脑有域管理的时候。最关键的一步来了Advanced Installation Options页面有两个勾选项Add Anaconda3 to my PATH environment variable添加Anaconda到系统PATH环境变量Register Anaconda3 as my default Python 3.11把Anaconda的Python注册为系统默认Python官方文档的建议是两个都不勾理由是避免干扰系统里已有的多个Python环境。但从我这些年带新人的经验和2023年实际状况来看如果你的电脑只是日常办公加学习Python没有同时操作多个解释器的需求我建议把第一个Add Anaconda3 to my PATH environment variable勾上。这样你在任意终端窗口就能直接使用conda和python命令省去了每次都要打开Anaconda Prompt的别扭。注意如果你是用公司电脑系统里可能已经装了公司定制版的Python或者其他开发环境那还是老老实实全都别勾后面用Anaconda Prompt来操作。毕竟多一个Path入口就可能让系统里其他软件引用了错误的Python这种问题排查起来非常痛苦。3.2 解释器安装完成后为什么Anaconda Prompt仍然打不开conda安装完后开始菜单会出现Anaconda的文件夹里面有Anaconda Prompt和Anaconda Navigator等快捷方式。不管前面PATH勾没勾第一次都建议用Anaconda Prompt来验证。打开Anaconda Prompt输入conda --version python --version如果正常会分别打印conda的版本号和Python版本号。Anaconda 2023.09对应输出的Python版本应该是Python 3.11.x。这一步验证成功后说明安装没问题。但如果前面没勾选Add to PATH那么在普通的cmd或Windows Terminal里输入conda会提示找不到命令。这正是很多新手卡住的地方。解决方案有两个方向要么从开始菜单打开Anaconda Prompt使用要么手动把Anaconda目录下的三个路径追加到用户环境变量里D:\Study\Anaconda3 D:\Study\Anaconda3\Scripts D:\Study\Anaconda3\Library\bin这三个路径缺一不可。Scripts里放着conda可执行文件Library\bin里则是一堆运行时动态库。只加前两个有时conda能启动但运行结果会报缺DLL。我发现网上很多教程没讲清楚只让加前两个路径这也是很多人看教程配完依然报错的根源。3.3 macOS和Linux安装时需要额外注意的点macOS双击pkg文件后下一步会安装到/opt/anaconda3目录加载完按提示走完。在Apple Silicon上安装时系统可能会提示无法打开因为无法验证开发者需要去系统设置 - 隐私与安全性里点仍要打开。这一步很隐蔽但2023年不少M芯片用户都栽过。macOS安装完成后需要在终端里运行conda init zsh或conda init bash让conda的初始化代码写入shell配置文件。不然你开一个新的终端窗口会发现conda命令完全不存在。之所以要多这一步是因为macOS与Windows不同图形化安装器不会主动帮你写入shell环境需要手动激活一次。Linux则是bash Anaconda3-2023.09-0-Linux-x86_64.sh后一路yes最后照样运行conda init zsh或bash。4. PyCharm配置Anaconda解释器让IDE和conda真正联动Anaconda装好了环境再干净也得让PyCharm知道用哪个解释器来跑代码。这一步是环境配置里最容易出问题的地方但我保证你看完下面这段思路后不会再犯。4.1 新建项目时怎么选Conda EnvironmentPyCharm下载安装后第一次打开会有一个配置界面向导。如果你已经装了Anaconda在创建新项目时界面里会看到Python Interpreter相关的设置选项。2023版PyCharm的这块UI跟之前版本略有调整但只要找到Interpreter那一行边上的齿轮或Add Interpreter按钮就行。点击添加后选择Add Interpreter - Add Local Interpreter - Conda Environment在弹窗里有几个关键选项Environment选择Use existing environment因为我们已经装好Anaconda了在解释器列表中选择base环境下的python.exe那么explorer里找到的是Anaconda目录下的python.exe还是envs里的python.exe这里有一个很核心的概念Anaconda安装完成后自带一个默认环境叫base而base环境对应的python.exe路径就在Anaconda的根目录下比如D:\Study\Anaconda3\python.exe。你选择这个就相当于使用了Anaconda默认环境。如果你打算为单个项目创建一个新的conda虚拟环境也可以选择Create new environment。对于入门来说先直接用base环境跑起来最省心虚拟环境的事放到第5节再讲。选完base环境的python.exe后PyCharm需要一点时间扫描并索引这个解释器里已有的所有包。等右侧列表里能看到numpy、pandas等库都列出时点击OK项目解释器就配好了。4.2 已有项目想要切换解释器的标准路径有很多人是先装了Anaconda又用PyCharm建了个项目跑代码时提示No Python interpreter configured for the project。这时你不用删除项目重来打开PyCharm的SettingsFile - Settings - Project - Python Interpreter点击Add Interpreter - Add Local Interpreter同样选到Conda Environment再选择已有的conda环境。Apply之后项目就会重新加载解释器。这里再补充一个细节2023版PyCharm界面的Settings入口依然在File菜单下没有跑到别的位置。但一些新用户会找不到Add Interpreter按钮因为新版界面上它藏在一个齿轮图标里或者需要滚动一下设置窗口。看右上角区域通常有个Add Interpreter下拉按钮点开后选Add Local Interpreter。示例如果你想看当前PyCharm到底用的哪个python.exe可以在PyCharm自带的Python Console里执行import sys print(sys.executable)输出路径如果指向Anaconda的python.exe或者某个环境下的python.exe就代表配置正确。4.3 PyCharm自带终端识别不到conda命令怎么办解释器配好了PyCharm里写代码运行也没问题。但PyCharm底部有个Terminal窗口默认打开后会调用你系统里的shell。当你在这个Terminal里敲conda命令时发现提示conda: command not found或者conda 不是内部或外部命令是不是有点懵这个问题的本质是PyCharm的Terminal只是启动一个新的命令行窗口它使用的环境变量来自PyCharm进程继承来的系统环境变量。如果你安装Anaconda时没有选择添加PATH那么PyCharm的Terminal自然不认识conda。最简单的解决办法是确认两点如果安装时勾选了把Anaconda加入PATH重新启动PyCharm后再开Terminal就能识别conda如果没勾选可以只在该Terminal里临时切换到Anaconda的conda环境。例如Windows下使用Anaconda的批处理文件来初始化D:\Study\Anaconda3\Scripts\activate.bat之后conda命令就能用了。macOS或Linux下则对应source /opt/anaconda3/bin/activate同时为了以后方便也可以直接在PyCharm的Settings - Tools - Terminal里把辅助shell路径设置为Anaconda的shell初始化脚本不过新人不建议急着改这个能跑通conda再说。5. 用conda虚拟环境隔离项目依赖2023年值得养成的习惯等你多写几个项目就会明白环境隔离不是技巧而是刚需。5.1 为什么2023年还在反复强调虚拟环境假设你现在有一个爬虫项目用到了BeautifulSoup和Scrapy两套库另一个数据分析项目需要pandas和matplotlib。都装在base环境里暂时看起来相安无事。等哪天开发一个老项目它只兼容Python 3.8而另一个新项目需要Python 3.11你总不能反复卸载重装Python解释器吧。conda虚拟环境就是为这个场景生的每个环境相当于一个独立的Python安装目录有自己独立的包集合环境之间完全隔离。你可以在一个电脑上同时存在Python 3.8、3.9、3.11等多个环境互不影响。PyTorch这类深度学习库对版本极度敏感的时代2023年很多新版本的库要求特定Python版本这种隔离的价值会被进一步放大。你给每个项目建一个环境需求变了就换环境跑环境烂了直接删掉重建完全不用动系统Python。5.2 用命令行创建conda虚拟环境的完整流程打开Anaconda Prompt执行conda create -n yolo_env python3.9其中-n yolo_env是给环境取名叫yolo_envpython3.9指定在这个环境里使用Python 3.9。命令执行后会问你是否继续输入y回车就会自动创建。此时环境中是干净的只有一个Python 3.9解释器和pip等基础工具。激活环境conda activate yolo_env注意在Windows旧版本中激活命令是activate yolo_env但2023版本的Anaconda已经全面推荐使用conda activate系列命令。激活后命令行前面会显示当前环境名例如(yolo_env) PS D:\。然后就可以往这个环境里装包了conda install numpy pandas matplotlib pip install requests注意conda install和pip install在虚拟环境里装的东西都是独立的不会跨环境串。装完想退出环境conda deactivate查看电脑上现有全部环境conda env list确定不用某个环境了可以执行conda remove -n yolo_env --all5.3 PyCharm里怎么切换到刚建好的conda虚拟环境环境建好只是第一步PyCharm要能识别它。操作路径依然是项目设置里的解释器选择页面File - Settings - Project - Python Interpreter点Add Interpreter - Add Local Interpreter - Conda Environment - Use existing environment这时候环境下拉列表里会出现你刚才建的所有conda环境。如果你下拉列表里没找到自己刚创建的环境就点右侧的浏览按钮手动定位到Anaconda目录下的envs\yolo_env\python.exe。这个目录结构很规律所有conda环境都在Anaconda3\envs文件夹下每个环境一个子目录里面是完整的Python安装。环境选对后PyCharm的依赖列表会更新为该环境下的包。这之后你写代码所依赖的库全都由该环境提供base环境里的事跟你这个项目就无关了。6. 安装和使用中最高频的报错与解决方案环境配置这东西包你配的过程中不出点报错几乎是不可能的。最后分享几个 2023 版本下最常见的坑都是从实战里捞出来的按诊断思路来给你捋清楚。6.1 CondaHTTPError一定是源的问题用conda安装包时最经典报错长这样CondaHTTPError: HTTP 000 CONNECTION FAILED for url https://repo.anaconda.com/pkgs/main/...原因就是conda默认的软件源在国外国内访问不稳定。解决办法是换成清华源。在命令行执行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的配置文件.condarc就会被写入到用户目录下。Windows的路径一般是C:\Users\你的用户名\.condarcmacOS/Linux在~/.condarc。如果哪天想恢复默认源直接删除这个文件即可。还有一个细节2023年前后端经常遇到有人加了源但依然连接超时。这通常是你用的镜像地址前缀写错了或者某些渠道带了不存在的旧路径。我实测的可用写法就是上面这种带/anaconda/pkgs/的。另外pip源也可以一并改了在系统或用户目录新建pip.iniWindows或~/.pip/pip.confmacOS/Linux写入[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cn6.2 conda命令找不到先判断是全局还是单终端问题这个问题的报错表现分两类一类是Anaconda Prompt里能查conda版本但cmd里查不到。另一类是多个终端都找不到。第一类大概率因为你没有勾选添加PATH解决办法见第3.2节手动配置环境变量。第二类则可能是安装过程中断或环境变量被其他软件覆盖可以在系统Path里检查Anaconda路径是否还在如果路径还在但仍然找不到就需要去Anaconda安装目录下重新执行一次python -m conda initWindows则用对应activate脚本重设环境。记住一个原则出了问题先区分是全局性还是局部性能少走一半弯路。6.3 PyCharm里import numpy报ModuleNotFoundError代码里import numpy报ModuleNotFoundError: No module named numpy但你在Anaconda的base环境里明明能用。这种就是PyCharm选择的解释器不是你想的那个解释器。很多人在settings里看着解释器路径选对了但实际运行时项目右下角或右上角的解释器状态还停留在旧配置。检查方式看PyCharm窗口右下角的状态栏通常会显示当前解释器路径也可以在File - Settings - Project - Python Interpreter重新确认。改完后最好重启一下PyCharm的Python Console旧会话仍持有旧解释器也是常有的事。6.4 conda环境弄坏了怎么快速重建环境配置过程中最常见的手滑是把某个依赖包升级了导致一堆库崩掉。很多人这时候尝试逐个回滚版本越滚越乱。我的经验是如果已经折腾超过半小时就不要修了直接重建环境。反正所有项目依赖都写在requirements或environment.yml里10分钟能把环境恢复回来。导出当前环境的依赖清单conda env export environment.yml在目标机器或新环境上重建conda env create -f environment.yml如果只是需要包名列表用pip freeze requirements.txt也可以。但conda环境导出会更完整地记录渠道和平台信息跨平台重建成功率更高。这个习惯在2023年尤其重要因为越来越多库转向按需加载依赖树复杂靠人工梳理维护成本极高用配置文件一键重建才是正确姿势。最后说点个人的习惯。我给自己定了一条规矩所有数据、代码、环境相关的安装目录都不放C盘Anaconda统一安装在D盘某个纯英文路径下PyCharm项目统一丢到另一个独立目录。这样哪怕系统盘崩了重装环境也还在即使环境彻底坏了删掉Anaconda目录重新装一遍半天内就能恢复所有工作环境。很多人栽跟头不是安装步骤多难而是从一开始就没在关键节点上给自己留退路。配置环境这关过得越早后面学Python的路越顺。