news 2026/9/18 15:06:15

PyCharm与Anaconda安装配置全攻略:从零搭建Python开发环境

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
PyCharm与Anaconda安装配置全攻略:从零搭建Python开发环境

把Python开发环境搭利索这件事,看着简单,实际操作起来坑真不少。PyCharm和Anaconda的组合是很多Python开发者入门的标配,但我在各种技术社区看到最多的问题恰恰是这两个工具装完不知道怎么配、配完跑不起来、或者装好了包却导入失败。这篇文章就带着你从头到尾把这两个工具装明白、配顺畅,内容全部基于我这些年重复过无数次的实操经验来写,每一步都有明确的理由和验证结果。

这套组合最合适的用户其实分三类:第一类是刚学Python的小白,需要把环境变量、解释器、包管理器这几个概念一次搞清楚;第二类是转行做数据分析或机器学习的工程师,需要用Anaconda管理复杂的科学计算依赖;第三类是平时写脚本、做自动化、维护多个项目的老手,想从零系统整理自己的开发环境。不管你是哪一类,这篇文章都能让你少走弯路。

1. 动手之前先想清楚两件事

1.1 PyCharm到底选社区版还是专业版

很多人第一次下载PyCharm就被两个版本弄懵了。社区版免费开源,专业版收费但功能更多,比如远程开发、数据库工具、Django/Flask等Web框架的专属支持。我的建议非常简单直接:一般情况下都用社区版,完全够用。你现在装好环境后,写Python脚本、做数据分析、调Pandas、跑机器学习模型,社区版一个都不会拖后腿。专业版那些高级功能,只有做Web全栈开发的人真正用得上。

至于激活的问题,我只说一句:请优先使用正版途径。如果你是学生或者老师,可以用学校邮箱申请JetBrains全家桶免费教育授权;如果你是个人开发者,社区版本身就是最好的选择。网上流传的各种激活码和破解工具,一来不稳定,二来有安全风险,没必要在自己电脑上埋雷。

1.2 Anaconda到底解决什么问题

在讲安装之前,必须先说清楚为什么要装Anaconda。很多人在这一步容易迷糊:PyCharm是个编辑器,它本身不负责帮你管理Python环境,它需要找到一个已经装好的Python解释器才能运行代码。而这个解释器从哪来?最原始的方式是去python.org下载官方安装包,但这样会有问题:你装的每个项目如果都要单独装依赖,很容易把系统折腾得乱七八糟。

Anaconda帮你解决了两个大麻烦。第一,它自带一个Python解释器,同时附带几百个Python数据分析、科学计算常用的包,装完就能直接用,不用一个个去pip安装。第二,它带有conda这个包管理和环境管理工具,能像给手机开应用分身一样,给不同项目创建完全隔离的Python环境——A项目用Python 3.8和PyTorch 2.0,B项目用Python 3.10和TensorFlow,互不干扰,这才是Anaconda最值钱的功能。

2. Anaconda安装全程拆解

2.1 下载安装包先看这三个地方

下载Anaconda,优先去官方渠道或国内镜像站。官方地址是https://www.anaconda.com/download,打开之后它会自动识别你的操作系统,Windows用户直接点Download按钮就行。如果你在官网下载速度慢或者卡在中间下载失败,推荐使用清华大学的开源软件镜像站:https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/,找最新的Windows-x86_64.exe文件即可。

这里要说几个下载时最容易踩的坑。第一,看清楚系统位数,现在绝大部分电脑都是64位,确认下载的是x86_64版本,不要下载32位的x86版本,否则后续装有些包会报错。第二,Anaconda官网偶尔会提示你下载Miniconda,Miniconda是Anaconda的精简版,没有预装那些科学计算包,需要手动装。新手根本不建议碰Miniconda,老老实实下载完整版Anaconda。第三,不要在百度搜索“Anaconda下载”就直接点进去,国内很多站点挂的是旧版本或捆绑安装包的假链接,认准官网和清华镜像这两个来源就对了。

2.2 Windows安装全流程与注意事项

下载好安装包后,双击启动安装程序,这一步里面有几个关键选项直接决定你后面省不省心。安装的时候强烈建议选择"Just Me"方式安装,不要选"All Users",后者涉及到系统权限,后续创建环境的时候容易遇到无法写入的问题。安装路径这一项我很认真地建议你改一下,不要用默认路径里的中间带空格的目录,比如"C:\Users\你的名字\anaconda3",或者直接装在某个盘的根目录下,比如"D:\Anaconda3"。为什么这么强调?因为后续如果要用conda安装某些深度学习的包,路径带中文或者带空格,有极小概率会触发奇怪的编码错误,排查起来相当头疼。

安装到中间一步会出现两个勾选框。一个是"Add Anaconda3 to my PATH environment variable",另一个是"Register Anaconda3 as my default Python 3.x"。早期版本的安装程序还会默认帮你勾上第一个,现在版本的默认值已经变了,我强烈建议直接把这两个选项全部勾上。这样的话Anaconda会自动帮你配置好环境变量,你之后在CMD里输conda、python、pip命令都能直接识别,省去一堆手动配置的麻烦。很多教程说要手动配环境变量,其实现在只要你把这个勾选上,就完全不用再手动配置了。如果你装的时候忘记勾选,也别着急,后面有一节专门教你怎么补救。

2.3 验证安装并配置国内镜像源

安装完成之后,重启一次电脑(这一步是真的需要,否则环境变量有可能不生效),然后按Win+R键打开运行框,输入cmd打开命令行窗口。依次输入下面三条命令检验安装是否成功:

conda --version python --version pip --version

正常情况下,你会看到conda和Python的版本信息分别打印出来。如果提示“conda不是内部或外部命令”,说明环境变量没有配好,直接看我后面常见问题那一节的处理方法。

接着需要做一件很重要的事:配置国内镜像源。Anaconda默认的下载源在国外,在国内网络环境下用conda安装包和创建环境时会非常慢,甚至经常出现连接超时。解决办法是把conda和pip的下载源都替换成清华镜像:

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 install和conda create的时候,就会自动从清华镜像拉取数据包,速度和稳定性会有质的提升。pip也可以顺手配置一下,Windows下在CMD里执行:

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

这样做是好习惯,因为后面你在PyCharm里用pip安装第三方包时,也会自动走清华源,不用再担心超时。

2.4 关于macOS和Linux的补充说明

macOS用户和Windows的安装流程差别不大,下载pkg安装包后双击安装即可。有一个需要注意的地方是macOS可能提示你安装Python 3的command line developer tools,直接同意即可。

Linux服务器上安装Anaconda,最稳妥的方式是下载安装脚本并执行:

wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-2024.02-1-Linux-x86_64.sh bash Anaconda3-2024.02-1-Linux-x86_64.sh

在Linux安装时,我强烈建议你在最后一步选择“yes”,让安装脚本自动写入.bashrc配置环境变量。如果选了no,后面就需要手动在.bashrc里添加并source生效,操作繁琐且容易遗漏。安装完成后,执行source ~/.bashrc让环境变量立即生效,不执行的话你当前这个终端窗口依然找不到conda命令。

3. PyCharm安装与首次配置

3.1 下载安装,语言和版本怎么选

PyCharm的官方下载地址是https://www.jetbrains.com/pycharm/download/,打开后页面会直接给你两个大按钮,对应社区版和专业版,按照前面说好的,咱们下载社区版就行。下载完直接双击安装,安装过程中的选项基本不用动,全选默认即可。

装完第一次启动PyCharm,它会问你是否导入之前的设置,新用户直接选Do not import settings,然后开始配置界面主题。如果你是英文界面用着吃力,可以在欢迎页左侧选择Plugins(插件)选项卡,然后在搜索框里输入“Chinese”,安装那个名为“Chinese Language Pack”的官方简体中文语言包,装完后重启PyCharm就能看到完整的中文界面。这个操作在所有JetBrains系软件里通用,以后装IDEA、WebStorm都可以用同样方式汉化。

3.2 最关键的一步:关联Anaconda解释器

现在到了整个流程最核心的地方。打开PyCharm后,首先创建一个新项目,在New Project窗口里,你会看到左侧的Python和Pure Python等选项。这时候最需要注意的就是右侧解释器设置,千万不能选那个“Previously configured interpreter”后再随便挑一个没用的,新手建议直接保持默认的第一个选项——但是要确认一下它是不是使用了咱们刚装的Anaconda。

具体操作是这样的:点开"Previously configured interpreter"下的Interpreter下拉框,选择"Add Interpreter",再选择"Add Local Interpreter"。在弹出的窗口中,右侧第一个选项就是Conda Environment,这个选项只有在电脑上安装了Anaconda后才会出现。选它,然后点击"Generate New"下面的Python版本下拉框,选一个你需要的版本(比如3.9或3.10),PyCharm会自动关联到你Anaconda里的基础环境。实际上更简单的办法是,如果你已经装好Anaconda,PyCharm初始化新项目时会在解释器位置自动帮你选中Conda环境,你只需要确认并一路Next就行。

关联好之后,进入PyCharm主界面,点击右下角的状态栏显示Python版本信息的那一刻,说明这个项目已经和Anaconda的Python解释器成功绑定。

3.3 新项目里验证环境是否真的通了

作为验证,先在项目里新建一个Python文件,随便命名为test.py,输入最经典的:

import sys print(sys.executable)

右键运行就能看到结果,如果输出的路径指向你的Anaconda目录,说明解释器配置成功。接下来再顺手验证一下科学计算包是否可用,比如试试导入pandas和numpy:

import pandas as pd import numpy as np print(pd.__version__) print(np.__version__)

如果Anaconda完整版安装正常,这两个包是直接预装好的,运行不会报错。如果你发现提示ModuleNotFoundError,别慌,十有八九不是环境坏了,而是你选的解释器不是Anaconda自带的那个,回看上一节的步骤重新关联一次。

3.4 在PyCharm里安装第三方包的正确姿势

前面说到Anaconda自带了几百个常用包,但真实开发中你总会碰到一些没预装的库,比如requests、scrapy、pandas的升级版等等。这时候有三种安装方式,我个人最推荐你的操作顺序是:先试conda,再试PyCharm的界面,最后才用pip。

先从PyCharm界面说明白:文件菜单 -> 设置(Preferences) -> 项目 -> Python解释器,右侧会列出当前环境已经装好的所有包。点左边的加号按钮,搜索你想要的包名和版本,然后点击Install Package就行。这种方式适合找包、看不熟悉库的文档时用。

如果你已经明确知道要装什么库,终端里使用命令行更快。在PyCharm底部打开Terminal面板,此时它会自动进入当前虚拟环境,你直接输入pip install requests回车,走的就是清华镜像源,一般几秒就能装完。

4. 用conda虚拟环境给项目做隔离

4.1 为什么每个项目最好都有独立环境

很多初学者刚开始把所有的包都装在Anaconda基础环境里,一开始没什么感觉,等到项目越来越多就会出现各种问题:项目A需要用numpy 1.x版本,项目B却要求numpy 2.x,升级一个项目把另一个搞崩了。这种依赖地狱在Python开发里太常见了。

conda虚拟环境就是为这个问题设计的。它本质上是在Anaconda里创建多个互不干扰的Python小世界,每个小世界有自己独立的包集合和版本号。创建环境只需要一条命令,切换环境也只需要一条命令,成本极低,但收益极高。我现在给自己定的规矩是:每个独立项目、每个不同Python版本需求、每个不同框架组合,都单独建一个环境,基础环境只用来装日常通用的工具包。

4.2 创建、激活、删除环境的一整套命令

用命令行操作conda,你需要打开Anaconda Prompt(在开始菜单里搜索),或者用普通的CMD也可以,因为咱们装的时候已经勾选了自动添加环境变量。常用命令我给你整理成一组可以直接照抄的:

# 创建一个名为py310、Python版本为3.10的环境 conda create -n py310 python=3.10 # 激活刚刚创建的环境 conda activate py310 # 查看当前环境里装了哪些包 conda list # 给当前环境安装一个包 conda install numpy # 退出当前环境,回到基础环境 conda deactivate # 查看电脑上现在有哪些环境 conda env list # 删除一个环境 conda env remove -n py310

这条创建命令执行后,conda会先分析依赖关系,然后询问你是否确认安装,输入y回车就继续。它有可能会去下载Python 3.10相关的包,第一次创建环境时稍微等一会是正常的,毕竟要下载几十兆的安装文件。因为配了清华镜像,实际等待时间会短很多。

4.3 创建完虚拟环境后怎么在PyCharm里切换

环境在命令行里创建好了,接下来可能会遇到一个细节:PyCharm里看不到它。这时候你需要在PyCharm设置里更新一下解释器列表。文件菜单 -> 设置 -> 项目 -> Python解释器,点击解释器下拉框,选择"Show All",然后点加号,选择"Conda Environment",下面再选"Existing Environment",后面那个下拉框里就能看到你之前创建的所有conda环境了,选中它应用即可。

把某个项目绑定到新环境之后,最直观的改变是右下角显示的解释器路径会从base环境切换成你指定的py310环境。以后你在该项目里pip install任何包,都只会装到py310里,不会污染别的项目环境。这个过程逻辑上非常简单,但确实是我见过新手最容易出问题的地方之一——因为很多人不知道环境切换之后,PyCharm里也需要手动重新关联解释器。

5. 常见问题排查与避坑记录

5.1 一堆高频报错和解决办法速查表

下面这些是我在帮别人排查问题时,最高频遇到的情况,整理成一个速查表给你:

现象可能原因解决办法
cmd里输conda提示不是内部或外部命令环境变量没配置好手动添加Anaconda路径到PATH环境变量,见5.2节
PyCharm里导入pandas报No module named项目用的不是Anaconda解释器去设置里把解释器切换成conda环境
conda create时一直停留在Solving environment网络问题或源太慢确认已配置清华镜像源,重启CMD重试
pip install后PyCharm里还是导入失败PyCharm加载的包列表没刷新在设置里切换到其他解释器再切回来,或重启PyCharm
运行某个库报Microsoft Visual C++ 14.0 is required该库的编译依赖缺失安装Visual C++ Build Tools,见5.3节
安装Anaconda后电脑原有的Python版本不见了环境变量优先级问题在PATH里调整两个Python的先后顺序
磁盘空间越来越小,Anaconda占了几十个GB多个环境+缓存过多定期conda clean -a清理缓存

5.2 环境变量那点事:装完conda命令找不到怎么办

如果你安装Anaconda时没勾选"Add to PATH",或者用了解压版的Miniconda,就会出现CMD里输conda没反应的尴尬局面。解决办法很简单,手动把三个路径加到系统环境变量的Path里:Anaconda安装目录本身、安装目录下的Scripts文件夹、安装目录下的Library\bin文件夹。在Windows上操作是这样的:右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量,在下面那栏“系统变量”里找到Path,点编辑,然后新建三条分别填入上面的路径。

这里有个值得注意的细节:如果你电脑上已经装了官方Python,并且它的路径在Anaconda前面,那你执行python命令时实际跑到的是官方Python而不是Anaconda的。这会引发一个奇怪的现象——python能运行,但import pandas却报错。解决办法是在Path里把Anaconda的相关路径上移到官方Python之前。这也是我强烈建议新手直接在安装时勾选Add to PATH、并且不要另外单独装官方Python的原因。

5.3 编译报错:Microsoft Visual C++ 14.0 is required

在Windows上用pip安装一些含有C扩展的包(比如matplotlib、scrapy、某些深度学习库的依赖)时,经常会看到这一长串报错。很多人一看是Visual C++就懵了,以为要去装整个Visual Studio,其实完全不需要那么大工程。

你只需要进入https://visualstudio.microsoft.com/visual-cpp-build-tools/,下载Visual C++ Build Tools,安装时勾选“使用C++的桌面开发”这一个工作负载,安装完重启电脑,报错基本就会消失。这个工具链本质上是给Python包提供编译环境。如果你平时主要用conda来安装包,conda会自动帮你下载预编译的二进制包,一般不容易触发这个错误,只有直接pip install某些从源码编译的包时才会遇到。

5.4 遇到包下载很慢或者超时的处理策略

这个问题我反复强调过,配置镜像源是第一优先级的动作。但如果你已经配了清华源,仍然有某个包下载缓慢,最直接的替代方案是临时使用其他镜像源,比如阿里云的PyPI镜像:pip install 包名 --index-url https://mirrors.aliyun.com/pypi/simple/,这样一条命令临时指定源,不会改动全局配置,很适合救急。

还有一类情况是conda install在解析依赖时卡住,长时间显示Solving environment。很多人的第一反应是强制终止进程,其实更好的做法是给conda加一个默认的低优先级求解器配置,或者直接改用mamba——它是一个用C++重写的conda替代命令,解析依赖速度快一个数量级。在基础环境里执行conda install -n base mamba -c conda-forge,之后把conda install换成mamba install即可。

5.5 误删环境的后悔药:环境备份与恢复

如果你操作比较频繁,我建议养成给环境做记录的习惯。定期执行conda env export -n 环境名 > environment.yml,把环境里的包列表和版本号导出到配置文件。以后即使环境被误删,只要执行conda env create -f environment.yml,就能基本恢复出原来的环境。这个操作很轻量,但对项目可复现性帮助很大,特别是以后你有同事要协同开发、或者换新电脑时,这个文件直接扔给对方就搞定。

5.6 我建议你跳过的一个大坑

网上有个流传很广的教程,会在Anaconda安装好之后,让你用pip install --upgrade pip把pip升级到最新版本,然后立刻去装一堆包。这件事本身不算错,但如果你直接升级conda基础环境里的pip,很有可能后面Anaconda自带环境的某些包版本会不再兼容。我的做法是,维持Anaconda基础环境的pip版本,只在需要升级的虚拟环境里单独升级pip。基础环境的稳定性优先级远高于新版本的新功能。

个人体会收尾

把PyCharm和Anaconda这套环境装好、配置顺畅之后,你后面用Python做任何方向的开发都会顺手很多。我在实际使用中最大的感受是,环境和工具选择这件事容不得懒,每次想图省事把各种包堆在同一个环境里,最后都会以某次项目冲突破坏收场。建议你从第一天就开始用虚拟环境隔离项目,养成习惯后不光是Python,你在用Node.js的npm、R的renv、Go的模块时,也会自然而然产生同样的隔离意识,这种工程化习惯会跟着你走很远。最后再分享一个小技巧:装完环境和解释器后,建议你花十分钟去Anaconda Navigator里看一眼每个环境对应的包列表,眼见为实地把环境和包的概念对上号,这会比任何文字说明都能帮你建立一个牢固的心智模型。

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

LLDB调试完全入门:从基础命令到实战排查技巧

做iOS开发这几年,我越来越觉得LLDB是那种“平时不怎么在意、一到关键时刻能救命”的工具。这话一点不夸张:你在Xcode里点那个“继续”按钮、在断点行上看变量、往控制台敲po self.model,底层全是LLDB在干活。LLDB的全称是Low Level Debugger&…

作者头像 李华
网站建设 2026/9/18 15:01:32

微医互联网医院平台架构:高并发、状态一致与HIS对接实践

简介:微医互联网医院平台详细介绍是一份面向医疗信息化从业者、互联网医院产品经理及开发人员的PPTX演示文档,系统梳理了互联网医院的整体产品架构与核心业务流程。内容从平台云端架构切入,重点拆解医师端与患者端两大入口:医师端…

作者头像 李华
网站建设 2026/9/18 14:57:18

编程Agent 装 emilkowalski/skills,TaoToken 接住 Claude Code 请求

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/18 14:54:10

YOLO+SAM自动图像标注:从检测框到像素级掩码的工程实践

1. 自动图像标注的底层逻辑与方案选型做过目标检测项目的人都有一个共识:模型训练本身花的时间,往往远不如标注数据花的时间多。一个中等规模的数据集,几千张图,纯手工拉框,一个人干一周是常态,标注质量还参…

作者头像 李华
网站建设 2026/9/18 14:53:14

Unity3D ACT游戏设计与实现:状态机、输入缓冲与战斗判定源码

简介:这份基于Unity3D的ACT游戏设计与实现毕业设计资料,面向计算机、软件工程等专业需要完成游戏方向毕业设计的学生,内容围绕一款以战斗为核心的2D动作游戏展开,覆盖绪论、开发工具及相关技术、游戏设计、测试与优化等完整论文结…

作者头像 李华