ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Anaconda与PyCharm搭建Python开发环境:从安装到联动全指南

Anaconda与PyCharm搭建Python开发环境:从安装到联动全指南 用Anaconda和PyCharm这套组合来搭建Python开发环境确实是目前最省心的方案没有之一。你如果有心去翻各大技术社区、培训课程、教学视频会发现几乎所有人都在推荐这套配对原因没有别的就是两个字省事。Anaconda帮你把Python解释器、常用科学计算库、包管理工具、虚拟环境管理全部打包搞定你不用再去官网下载Python再手动pip装一个个依赖库PyCharm则帮你把代码编辑、调试、终端、Git集成、远程部署这些东西全部收进一个界面里。两套工具各管一段互不抢活配合起来非常顺。这篇文章我会从零开始完整走一遍下载、安装、配置、联动的全过程。不管你是刚接触编程的纯小白还是以前用过其他语言、现在想转Python的开发者照着这篇文章操作都能顺利把环境跑起来。文末还整理了我这些年帮人排错时遇到的高频问题和解决思路属于常规教程里不会写、但实战中特别值钱的部分。1. 为什么是Anaconda和PyCharm而不是其他组合1.1 Python官方版、Anaconda、Miniconda怎么选很多新手一开始都会纠结一个问题官方python.org上下载的Python和Anaconda到底有什么本质区别打个比方官方Python像一个刚出厂的空房子只有最基本的水电管道你住进去之后缺什么得自己一件件添置而Anaconda是精装修交付常用的家具家电Numpy、Pandas、Matplotlib、Scikit-learn等都已经摆好了拎包入住。Anaconda底层仍然是标准的Python解释器只是预装了大量数据科学和机器学习领域的高频库同时附带了一套独立的包管理系统。如果你对硬盘空间比较敏感也可以考虑Miniconda——它是Anaconda的极简版只包含conda包管理器和一个基础Python其他库完全按需安装。我在实际工作中推荐分两种情况如果你不确定自己以后要装什么库、想一步到位不折腾装Anaconda如果你已经清楚知道自己只有两三个库的需求或者电脑配置偏低用Miniconda更轻快。但本文还是以Anaconda为主线来讲因为它的安装流程对新手最友好且覆盖绝大多数教程场景。1.2 PyCharm社区版和专业版到底差在哪PyCharm分社区版Community和专业版Professional两个版本很多教程直接推荐装专业版但我不建议一上来就装专业版主要原因是专业版是收费的虽然有30天试用期试用期过了还得处理授权问题极易踩坑。社区版永久免费对于纯Python开发来说完全够用——它支持代码补全、代码检查、调试器、测试工具、Git集成、虚拟环境管理这些日常使用的高频功能一个不少。专业版多出来的核心功能主要是Web开发框架Django、Flask等的深度支持、数据库管理面板、远程开发等。安装教程和激活教程里搜得最多的是pycharm激活相关信息我也说下这个热点问题社区版不需要激活下载安装后直接使用专业版试用期过后可以在JetBrains官网申请免费的教育授权如果你是学生或教师这是最合法也最省心的路子。2. 下载环节的细节与避坑指南2.1 Anaconda官网下载慢镜像站怎么选Anaconda的官方下载服务器在境外很多用国内网络环境的同学会产生一个大痛点点下载之后速度长期在几十KB/s甚至直接超时中断。这里有一个判断如果你的浏览器下载速度能稳定在1MB/s以上直接官方下载就好如果乌龟爬立刻换国内镜像源。清华大学开源软件镜像站mirrors.tuna.tsinghua.edu.cn是做Anaconda镜像做得最全、同步频率最高的一个。下载地址在https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/这个目录下可以发现所有历史版本的安装包命名规则是Anaconda3-版本号-Windows-x86_64.exe这样的格式。选版本时我有两个建议第一不要太老也不要太新选发布时间半年到一年的版本最稳妥因为新的版本偶尔会遇到个别第三方库尚未适配的情况太老的版本则缺少新功能第二确认操作系统位数现在基本都是64位系统直接选x86_64后缀的版本就行。2.2 PyCharm官方渠道下载与版本识别PyCharm的下载需要注意认准官方网站——在搜索框输入“PyCharm官网”时排名靠前的链接里会混着各种第三方下载站、汉化站、广告站稍不留意就会下载到捆绑了额外软件的安装包。官方下载地址一眼就能认出来域名里一定带jetbrains.com。国内用户可以访问https://www.jetbrains.com/pycharm/download/页面打开后会默认展示两个版本按钮左边是Community下载按钮显眼右边是Professional下载按钮同样显眼但标注了Trial。页面顶部一般会根据你的操作系统自动识别并推荐对应的安装包你也可以手动切换Windows、macOS、Linux三个标签。我个人的下载偏好是选择页面下方的Other versions入口进去后可以看到历史版本列表我一般不会盲目追最新版而是选择当前次新版本理由很简单新版本刚发布时往往会有一些插件兼容性问题次新版本经过一段时间的社区验证稳定性更有保障。3. Anaconda安装全流程解析3.1 Windows环境下Anaconda的完整安装步骤如果你用的是Windows系统双击exe安装包会弹出安装向导这里面的选项值得逐项注意。安装模式选择界面有Just Me和All Users两个选项除非这台电脑有多个用户都需要使用Anaconda否则务必选Just Me这个选项会把所有文件装到当前用户的目录下后续权限问题少很多。安装路径的选择是很多新手踩坑的重灾区——Anaconda默认的安装路径是C:\Users\用户名\anaconda3有人为了“方便管理”手动改成E:\软件\Python\Anaconda甚至D:\Program Files\Anaconda这样做虽然不一定会出问题但风险确实存在。为什么安装路径这么敏感因为Anaconda的虚拟环境管理、conda包更新、PyCharm联动时都会通过固定的路径规则来寻找解释器和库文件路径一旦包含中文、空格或特殊字符部分第三方库在编译时就会因为路径解析失败而报找不到文件。更好的实践是保持默认路径或者如果实在想装到D盘也不要使用带有中文和空格的目录名比如D:\Anaconda3就算比较合适的路径。关键的配置界面有个Add Anaconda3 to my PATH environment variable复选框默认是不勾选的这里建议手动勾选勾选后系统会把conda和python命令自动加到系统环境变量里这在后面对接PyCharm或使用命令行时都会省去各种麻烦。第二个复选框Register Anaconda3 as my default Python 3.x也建议勾选它会让系统把Anaconda带的Python作为默认Python版本。整个安装过程通常需要几分钟离开时不要急着关电脑等进度条跑完见到Successfully installed的提示才算彻底完成。3.2 macOS和Linux安装时的关键区别苹果电脑和Linux服务器上安装Anaconda时路径规范和界面交互明显不同。macOS安装包有两种格式图形化的pkg格式双击后跟着向导点继续即可还有命令行用的sh脚本格式。我更推荐在macOS上使用pkg安装但对有一定命令行基础的人用sh脚本更灵活。安装完成后需要在终端里执行source ~/.bash_profile或重新打开一个新的终端窗口才能让conda命令生效。Linux服务器上安装Anaconda时流程是下载对应架构的Shell脚本然后在终端执行bash Anaconda3-xxx-Linux-x86_64.sh一路回车确认授权协议遇到是否将conda初始化追加到shell配置时输入yes。很多在Linux上已经安装过conda、后来又想换一个路径或者彻底卸载的同学会遇到shell中显示bash: conda: command not found的问题绝大多数都是环境变量配置没生效所致。Linux下建议安装完成后执行conda --version确认如果提示找不到命令手动在~/.bashrc末尾添加export PATH/你的安装路径/anaconda3/bin:$PATH然后执行source ~/.bashrc。3.3 第一次启动前的环境变量检查安装完成并不意味着万事大吉第一时间打开一个新终端Windows上按WinR输入cmd回车输入conda --version和python --version来验证是否安装成功。如果命令能正常输出版本号说明环境变量已经生效。如果提示“不是内部或外部命令”或“command not found”大概率是环境变量没配好Windows下可以到“设置—系统—关于—高级系统设置—环境变量”在用户变量的Path里检查是否包含C:\Users\你的用户名\anaconda3和C:\Users\你的用户名\anaconda3\Scripts两项没有就手动加上。这一步检查非常关键很多教程跳过了这个验证环节导致后续在PyCharm里配置解释器时怎么都找不到conda环境回头才发现根本原因在环境变量。根据我在社区里帮人排查的案例统计至少有两成以上的“PyCharm用不了conda环境”问题源头都是这个环节没处理好。4. PyCharm安装与首次启动配置4.1 安装过程中的关键选项怎么选PyCharm的安装过程相比Anaconda要简单一些但是第一个界面就有讲究。安装向导第一步是选择安装路径这里我还是建个义保持默认目录因为JetBrains的IDE在更新和插件管理方面对默认路径的兼容性最稳。操作系统为Windows时接下来的选项里有Download 64-bit launcher——这是创建桌面快捷方式建议勾选Create Associations里会列出.py文件关联勾选后双击.py文件就会直接用PyCharm打开这个看个人习惯我建议勾上日常打开脚本文件确实方便Update PATH variable这个下拉框不选因为PyCharm本身不需要加入PATH。最后一步是Installation Type分有JetBrains Toolbox的多个版本的组合增量安装模式和Install for current user选择后者就行。安装包下载好之后双击运行等待完成即可。首次启动会弹出Import PyCharm Settings的对话框以前没用过就直接选中Dont import settings从旧电脑迁移过来或者曾经配置过其他版本的同学可以把之前的配置目录选中导入。4.2 界面语言设置中文插件还是系统英文界面PyCharm默认是英文界面对英文不好的同学来说会有点吃力。网上搜“pycharm怎么设置中文”的人非常多这里说下正确做法新版本PyCharm2020.1以后内置了中文语言包插件打开IDE后按快捷键CtrlAltS打开设置界面在左侧找到Plugins切换选项卡到Marketplace在搜索框输入Chinese找到Chinese (Simplified) Language Pack点击Install安装完成后按照提示重启IDE界面就会变成中文。不过我要给大家提个醒PyCharm英文界面的专业术语不算太复杂很多老开发者一直用英文界面主要原因是当你在网上搜索“Error building xxx”的报错信息时英文关键词的搜索结果往往更多而中文界面只是把界面文字翻译了代码运行报错仍然是英文。但你如果你是刚入门装中文包完全没问题等后面熟悉了再换回英文也不晚。4.3 首次启动的项目创建选择合适的新建方式打开PyCharm后第一步是创建项目。在Welcome界面点击New Project弹出的对话框里会有一个Location路径还有默认解释器设置。很多人第一次在里面看到的是Pure Python或者Python 3.x版本号这是你在系统中检测到的Python解释器可能来自Anaconda也可能不是。这里先不用急着操作等下一节讲完Anaconda和PyCharm联动后你再回过来重新选择解释器会更清晰。项目的Location命名同样注意不要带中文或空格PyCharm社区里报过不少类似C:\Users\张三\我的项目这种目录导致虚拟环境创建异常的问题。建议所有项目路径统一使用英文小写字母加数字的命名风格例如C:\Users\你的用户名\PycharmProjects\demo_first。这个习惯越早养成越好后面做Web项目、部署到服务器时都能少踩很多坑。5. Anaconda与PyCharm的联动配置5.1 在PyCharm中正确配置Anaconda解释器这一步是整个流程里最核心的也是最容易出错的。先在PyCharm里打开一个项目然后按CtrlAltS打开设置左侧导航中找到Project: 你的项目名 — Python Interpreter。点开这个页面后点击Python Interpreter右侧的下拉框如果列表里已经出现了Anaconda的Python解释器路径形如C:\Users\你的用户名\anaconda3\python.exe直接选中即可。如果是空的或者显示的不是Anaconda的路径点击Show All然后点加号选择Add Local Interpreter。弹出的窗口里选择Conda左侧标签这时界面会要求填写Conda可执行文件路径。正常情况下PyCharm会自动检测到conda.exe的位置如果没有自动填充你手动浏览到C:\Users\你的用户名\anaconda3\Scripts\conda.exe选中然后在Python version下拉框里选择一个期望的Python版本点击Load Environments系统会读取当前conda环境列表你可以选择某个已存在的虚拟环境作为这个项目的解释器也可以选择新建Conda环境。设置完成后回到主界面PyCharm会开始索引项目文件底部状态栏会显示环境信息说明联动配置成功。5.2 用PyCharm管理Anaconda虚拟环境配置好解释器之后你就能在PyCharm里使用Anaconda环境了。我见过很多同学的极端操作方式所有的项目共用一个base环境需要什么库就直接pip install把包装到base里时间久了base环境变得极其臃肿不同项目的依赖互相冲突一升级某个库另一个项目就崩。更合理的做法是为每个项目创建独立的conda虚拟环境。可以在刚才提到的Add Local Interpreter面板里选择New environmentName填一个辨别度高的名字比如项目名_py310Python version选3.9或3.10Location会自动生成一个Anaconda目录下的envs路径。以后每个项目的依赖库都在自己的环境里互不干扰这个做法在团队协作和项目交付时收益尤其明显。PyCharm的右下角会显示当前使用的Python解释器和conda环境名你可以随时点击它切换环境。5.3 在Terminal里用conda命令配合PyCharmPyCharm自带Terminal面板默认会启动项目所在目录的终端窗口。在配置好conda环境后进入这个面板执行conda activate 环境名就能在IDE内直接进行包管理操作。我日常在PyCharm里切换环境后大概率会先在这个终端执行一下python -m pip list看看当前环境里已装的库避免重复安装。有些同学会遇到打开Terminal后conda命令无效的困扰原因是这个终端默认用的是系统cmd或PowerShell没有初始化conda这时可以在Terminal面板的右上角找到设置按钮确认在Shell path里指定的是安装conda后的shell。6. 国内镜像加速与常规配置6.1 conda源设置为清华镜像Anaconda虽然自带了大量常用库但随着项目推进还是要不断安装新的包。默认的官方包源在境外安装速度有时慢到让人崩溃Python高频热门库可能等个几分钟都装不完。这里教一个提速方法在命令行里依次执行两条命令把conda的channel地址切换到清华镜像。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/执行完后建议顺手加上这两条把搜索时显示channel地址的功能关掉看起来更清爽conda config --set show_channel_urls yes然后执行conda config --show channels检查配置是否生效。这里有一个操作顺序的细节如果之前已经用官方源创建过环境、装过部分包切换镜像后出现某些安装包找不到的情况一般镜像源的包同步比官方源滞后强制指定了pinned版本时尤其容易出现。办法是安装时不要锁死patch版本号或者换用pip install走PyPI的清华镜像。6.2 pip源与conda源怎么协同工作一个经常会让人产生困惑的问题是装了Anaconda用conda就行干嘛还要用pip实际项目中两者经常并存。conda在某些场景下会更擅长管理带二进制依赖的包但如果某个库只在PyPI上发布了新版本conda源里还没有就必须用pip来安装。这种双通道的使用习惯本身没问题但需要注意使用场景的边界同一个项目里尽量保持conda管理conda装的、pip管理pip装的不要用两个工具反复安装同一个包否则可能把环境折腾出依赖版本混乱。pip的国内镜像配置是一次性的在命令行执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/以后pip install就会默认从清华PyPI镜像下载速度比官方源快几个量级。我在配置新环境时有时会顺手确认一下pip和conda的版本是否过老执行pip install --upgrade pip和conda update conda保持工具链更新避免因为工具太旧导致一些新库的元数据解析失败。6.3 验证配置是否成功跑一个小demo配置完成之后怎么确认这一整套环境真的能用很多同学装完环境就扔在一边到真正运行时才发现各种问题。建议在项目里新建一个测试脚本例如import sys import pandas as pd print(Python 版本:, sys.version) print(pandas 版本:, pd.__version__) df pd.DataFrame({科目: [语文, 数学, 英语], 分数: [92, 88, 95]}) print(df)右键选择Run如果控制台输出了Python版本、pandas版本并打印出一张DataFrame表格说明Anaconda环境的Python解释器、包管理、代码运行链路全部正常PyCharm和Anaconda的联动也宣告成功。这个小脚本建议在第一次配置完成后一定跑一次早发现问题远比以后在项目的某个模块里排查一个“环境没装对”要省时得多。7. 高频报错与排查实录7.1 conda命令无效与解决方案这是所有问题里出现频率最高的。Windows下安装完Anaconda后打开cmd执行conda命令提示“不是内部或外部命令”macOS或Linux上提示bash: conda: command not found核心原因集中在两点安装时没有勾选Add Anaconda3 to my PATH environment variable或者当前终端窗口是在安装Anaconda之前打开的没有刷新环境变量。前者去系统环境变量里手动添加Anaconda的路径后者关掉终端重开一个新窗口就能解决。如果是Powered shell或者macOS上用的zsh还需要确认环境变量配置写在正确的配置文件中.zshrc。7.2 安装pandas等包时提示Microsoft Visual C 14.0 is required这个报错在网络搜索热词里同样居高不下。安装一些包含C扩展的Python包时Windows下会提示error: Microsoft Visual C 14.0 is required. Get it with Microsoft C Build Tools。这是因为这些包在安装时需要本地编译C/C代码而系统中缺少对应的编译工具链。解决办法有两种优先推荐第一种尝试直接用conda安装例如conda install pandasconda一般会直接安装预编译好的二进制包不需要本地编译如果必须用pip安装就去微软官方网站下载Microsoft C Build Tools安装时勾选“使用C的桌面开发”工作负载安装完成后重启终端再装包基本就能通过。7.3 PyCharm里找不到conda环境或解释器有时在PyCharm里即便正确安装了AnacondaPython Interpreter的下拉列表中仍然不显示conda环境。排查思路按下面的顺序来首先在cmd里执行conda info --envs确认conda能正常列出所有环境其次确定PyCharm版本是否为较新的版本老版本对conda的识别确实存在一些bug最后在Add Local Interpreter面板中手动把Conda executable路径指向conda.exe并点击Load Environments如果能列出环境再勾选说明问题已解决。如果仍然没有把路径改为Python解释器本身的路径即你已经安装环境的/python.exe也可以作为兜底方案。7.4 新环境安装后code不能运行但没报错有一种让人摸不着头脑的情况PyCharm能正常打开项目代码里也没有明显语法错误但执行时没有任何输出。排查这类问题优先检查运行配置。点击右上角运行按钮旁的下拉菜单选择Edit Configurations确认Python interpreter选中的环境是你配置的conda环境Working directory设置的是当前项目目录。用已经配置好的conda环境在PyCharm的Project面板里找到main.py文件右键选择Run main就会看到输出直接出现在下方的Run工具窗口里。还有一个经常被忽视的点是控制台编码Windows下运行脚本输出中文有时会乱码或报错UnicodeEncodeError办法是手动设置环境变量PYTHONIOENCODINGutf-8或者在脚本开头加上import io, sys; sys.stdout io.TextIOWrapper(sys.stdout.buffer, encodingutf-8)。7.5 Anaconda卸载与重装时需要处理干净的残留有些人不小心把Anaconda装坏了或者装到一半中断导致环境异常想卸载重装。如果不把残留处理干净重装后还是会在相同的地方报错。卸载Anaconda窗口台面上直接找到Anaconda Navigator → File → Quit然后在开始菜单找Anaconda Uninstaller按照卸载向导执行。关键步骤是卸载后手动删除安装目录下还遗留的文件夹同时清理环境变量里与Anaconda相关的Path项。macOS和Linux也有类似的残留问题。重装时注意不要勾选“Register Anaconda as default Python”选项到已装的其他Python版本共存时否则可能产生冲突。8. 实战经验与我的推荐习惯8.1 我的虚拟环境使用习惯说个多数教程不会教你但实操很实用的习惯我通常会给每个项目都建一个独立环境哪怕只是一个课堂练习的小脚本。建环境的命令很简单在终端里执行conda create -n demo_env python3.10建好之后激活环境再进入项目目录就能在一个干净的环境里安装项目所需依赖不污染其他项目。我见过太多同学在base环境里直接pip install了一堆包然后遇到A项目需要Pandas 1.x、B项目需要Pandas 2.x的冲突相互升级导致其中一个跑不起来最后只能花大量时间定位依赖问题。虚拟环境巧妙之处在于它把依赖层面做了隔离环境之间各过各的日子互不干扰。哪怕是同一个人同一个项目隔几个月回头修改代码项目环境依然是旧的依赖版本这样的复现价值非常大。8.2 用conda还是pip装包的取舍这个选择新手经常犯难。我的大致判断标准是能用conda装的尽量用conda装因为conda不仅能管理Python包还能管理非Python的原生依赖对大量科学计算库的支持更完整。只有在conda源里确实找不到、或更新的速度太慢时才退回到pip安装。装的时候优先看看conda源里有没有比如Pytorch在conda源里版本可能比官方慢几天如果用不上最新的特性直接用conda装会更省事有其他情况需要官方最新发布版本的再用pip配合PyPI镜像源。8.3 给新手的完整流程清单按下面的清单走你在环境搭建这条路上可以少走八成以上的弯路在清华镜像站下载Anaconda最新稳定版安装时勾选Add to PATH选项保持默认安装路径。在JetBrains官网下载PyCharm Community版本安装完成后第一次启动选Dont import settings。新开一个终端输入conda --version和python --version验证环境变量生效。给termina配置conda和pip的清华镜像。在PyCharm中新建项目通过Add Local Interpreter配置conda环境和Python解释器创建一个独立的虚拟环境。新建测试脚本运行时验证整条链路确认无报错后再开始正式项目开发。9. 常见问题速查表症状最可能原因优先操作conda不是内部或外部命令未将Anaconda加入环境变量检查系统Path是否包含anaconda3和Scripts目录pip安装报VC 14.0编译错误Windows缺C构建工具用conda install替代pip或安装Microsoft C Build ToolsPyCharm里找不到conda环境Conda可执行文件路径未识别手动指定conda.exe路径并点击Load Environmentsconda安装包速度巨慢官方源延迟高配置清华镜像源后重试项目依赖版本冲突所有项目共用同一环境每项目创建独立conda环境搭建隔离环境依赖Anaconda安装中途失败残留旧版本或安装包不完整彻底卸载旧版清理目录和环境变量后重装10. 写在最后的几个小建议我在这方面踩过的坑其实不少最难排的一个是刚毕业那会第一次给别人分享环境配置经验讲的是“按教程装好就行”结果对方死活报错后来发现是对方公司电脑统一装了杀毒软件把Anaconda安装目录下的某些exe拦截了导致环境不完整。所以遇到莫名其妙的问题先留意下系统的安全软件或权限设置这种干扰源在官方文档里普遍不会提到。另外一个大实话是环境配置固然重要的但不要陷入在“配置环境”上花几天工夫的泥潭。Anaconda和PyCharm这套组合最大的价值不是让你成为环境配置专家而是让你快速跳过繁琐的搭台过程把时间和注意力放到真正需要写代码、跑数据、解问题上。如果你配置完成后第一次跑通demo心里浮现的是“原来这么简单”我的目的就达到了。之后不管你是要做数据分析、深度学习还是Web开发这套环境都能给你一个稳固的起点。
返回列表