Python开发环境搭建全攻略:PyCharm+Anaconda安装配置指南
2026/9/18 22:50:56 网站建设 项目流程

如果你正在翻安装教程,多半是卡在了同一个地方:Python环境看起来装好了,但代码一运行就报错。明明照着别人的博客一步步来,结果版本不一样、路径不一样,错得五花八门。我刚学 Python 那会儿也被 PyCharm、Anaconda、解释器、环境变量这几个词绕得晕头转向,后来把原理搞清楚,再回头看安装这件事,其实一点都不复杂。

PyCharm 与 Anaconda 这套组合,本质上就是分工合作:Anaconda 负责装好 Python 解释器、管理第三方库和虚拟环境,PyCharm 负责写代码、跑代码。这篇文章我会用最适合小白的操作路径,把下载、安装、配置、验证整个过程完整走一遍,每一步都会解释“为什么这么点”,而不是只给一个干巴巴的“下一步”。文章基于 Windows 系统最新版本编写,装完之后你能直接开始写第一个 Python 项目。

1. 为什么新人第一套开发环境,我推荐 PyCharm 搭配 Anaconda

1.1 先分清三个概念:Python、Anaconda、PyCharm

很多新手安装失败,不是因为操作难,而是从一开始就没弄明白这几个软件到底是什么关系。这里用个生活化的类比:

  • Python是“发动机”,它是真正执行代码的程序,没有它,你写的代码就是一堆普通文本。
  • Anaconda是一个“带工具箱的发动机套装”,它里面已经装好了 Python,并且预装了 numpy、pandas、matplotlib 等上百个常用库,还带一个叫 conda 的“自动加油机”,可以帮你安装、卸载、切换各种第三方库。
  • PyCharm是“驾驶室”,它负责让你舒服地写代码:代码高亮、自动补全、一键运行、断点调试,都在这里完成。

简单说:Anaconda 管理环境,PyCharm 写代码。写好的代码运行时,PyCharm 会把代码交给 Anaconda 里的 Python 解释器去执行。

1.2 Anaconda 真正厉害的地方是虚拟环境

如果你只是临时学两天 Python,直接用官网的 Python 安装包也够用。但只要你打算长期学习,或者未来做数据分析、爬虫、Web 开发,就绕不开一个难题——依赖冲突

举个例子:项目 A 需要 TensorFlow 2.4,它要求 Python 版本不能高于 3.8;项目 B 需要最新版 NumPy,而新版 NumPy 又要求 Python 3.9 以上。如果你只有一个全局环境,这两个项目就没法共存。

Anaconda 提供了虚拟环境功能,相当于给每个项目分配一个独立的“隔间”,项目 A 装什么都不影响项目 B。这是新手最容易忽略、但后期收益最大的功能。

1.3 为什么不用 VS Code,或者直接用记事本

PyCharm 不是唯一的选择,VS Code 也很流行,但它更适合有一定基础、愿意自己折腾配置的开发者。VS Code 的定位是“编辑器”,很多功能需要装插件、配 json 配置文件,这对新手来说很劝退。

PyCharm 是“开箱即用的 IDE”,装完解释器就能跑,几乎所有行为都有图形化界面操作。对于第一次接触编程的人,我更建议先把精力放在学习语法本身,而不是花大量时间研究编辑器配置。

提示:这篇教程里你会频繁看到“解释器”这个词。记住一句话就行:解释器就是那一份 Python 程序,PyCharm 选对了它,代码就能跑;选错了,就会报“No module”或者直接无法运行。

2. 安装前先做三件事:版本对应、下载渠道、旧环境盘点

2.1 版本怎么选:Anaconda 自带 Python,PyCharm 只是外壳

很多新手会问:我需要单独下载 Python 吗?如果你已经决定用 Anaconda,就不需要再单独下载 Python。Anaconda 安装包里自带了一个最新的 Python 版本,装好之后它自己就是一套完整的 Python 环境。

PyCharm 这边只分两个版本:Community(社区版)和 Professional(专业版)。社区版免费、开源,功能足够日常学习和绝大多数开发使用;专业版是收费的,多了 Web 框架、数据库工具等企业级功能。新人建议直接用社区版,等以后确实需要再升级,不需要提前买。

版本上不需要刻意追新。Anaconda 官网下载页会默认提供最新稳定版,你跟着这篇文章走就对了。千万不要去下载所谓的“整合版”“绿色版”,后面我会专门说下载渠道的问题。

2.2 下载渠道:认准官网,别被“高速下载”按钮骗了

这是一个非常关键的步骤,因为搜索结果里混杂着大量第三方下载站,它们的安装包不仅可能捆绑流氓软件,还可能是改过的旧版本。

  • Anaconda 官网下载页:https://www.anaconda.com/download
  • PyCharm 官网下载页:https://www.jetbrains.com/pycharm/download/

进入页面后,选择 Windows 对应的安装包。Anaconda 选择图形化安装程序(Graphical Installer),PyCharm 直接点 Download。不要理睬任何标着“高速下载”“立即下载”“破解版”的第三方站点。

下载体积上,Anaconda 安装包大约 500MB 左右,PyCharm 大约 400MB 左右,都不算小。如果你的网速比较慢,下载时可以顺便把浏览器挂后台,不要反复刷新,避免下载到不完整的文件。

2.3 安装前盘点:用三分钟时间排查老环境

装新环境之前,先花几分钟检查一下电脑上有没有装过相关的东西。这一步能省掉后面很多麻烦。

第一,打开「设置 → 应用 → 已安装的应用」,看看有没有“Python 3.x”“Anaconda”“PyCharm”字样。如果以前随便装过 Python,而且你也不是很确定自己用它做了什么,建议先把旧 Python 卸载,再装 Anaconda。因为 Anaconda 自带 Python,老版本的系统 Python 很容易造成 PATH 冲突,导致运行的时候不知道该用哪个。

第二,检查一下磁盘空间。Anaconda 装完约占 3GB 空间,PyCharm 占约 1.5GB。虽然不大,但建议至少留出 5GB 以上空间,免得后面安装过程中磁盘满了。

第三,把所有浏览器网页、Office 文档先保存好。安装过程中需要重启终端窗口,有些电脑可能还需要重启系统,提前做好保存比较稳妥。

注意:安装路径不能有中文,也不能有空格。比如D:\软件\Anaconda3就不行,建议用D:\Anaconda3或默认的C:\Users\你的用户名\anaconda3

3. Anaconda 安装全流程:每一步为什么这样点

3.1 安装界面逐项说明

双击下载好的 Anaconda 安装包,Windows 可能会弹出 UAC 用户账户控制提示,点“是”。接下来你会看到一个标准的安装向导,下面我把每一步拆开讲。

  • Welcome 界面:直接点 Next。
  • License Agreement 许可协议:点 I Agree(我同意)。
  • Select Installation Type 安装类型:选Just Me(仅当前用户)。如果选 All Users,之后经常遇到权限不足的问题,对新手来说没必要。然后点 Next。
  • 选择安装路径:默认路径通常是C:\Users\你的用户名\anaconda3。如果你有 D 盘,也可以改成D:\Anaconda3。再次强调,路径里不要有中文。

3.2 两个高级选项怎么勾:PATH 和默认 Python

这是整个安装过程中最容易犹豫的一步。界面上会有两个复选框:

  1. Add Anaconda3 to my PATH environment variable(把 Anaconda 添加到 PATH 环境变量)
  2. Register Anaconda3 as my default Python 3.x(把 Anaconda 注册为默认 Python)

关于第一个,官方默认是不勾选的。我会建议你保持不勾选。不勾选的意思是:普通命令行窗口(cmd)里直接输入 conda 会提示找不到命令,但你可以用开始菜单里的“Anaconda Prompt”来操作 conda,效果完全一样。

为什么不勾选更安全?因为勾选之后,Anaconda 会把它的 Python 强行放进系统全局 PATH,如果电脑上装了其他依赖 Python 的软件,比如某些工程软件、自动化工具,它们调用的可能不是你想要的 Python 版本,很容易出现莫名其妙的问题。

第二个“Register Anaconda3 as my default Python 3.x”可以勾上,它只是让系统和大多数工具知道,默认 Python 用 Anaconda 这份,一般不会有副作用。

3.3 安装完成后的验证三连

安装过程会持续几分钟,等进度条走完,会看到“Installation Finished”界面,默认会勾选“Anaconda Distribution Tutorial”这类宣传内容,你可以取消后点 Finish。

接下来打开「开始菜单」,找到刚安装的Anaconda Prompt,打开后输入命令验证环境是否正常:

conda --version

如果显示类似conda 24.x.x的版本号,说明 conda 就绪。

python --version

这一步会显示 Anaconda 自带的 Python 版本号,比如Python 3.12.x

conda env list

这一步会列出所有虚拟环境。刚装好的时候至少会有一个base环境,前面带一个*号,代表当前正在使用的环境。

三条命令都正常,Anaconda 部分就搞定了。如果提示“conda 不是内部或外部命令”,说明你可能不小心勾选了 PATH,又或者安装路径有问题。不用慌,这篇文章第 6 章有专门排查方案。

4. PyCharm 安装与激活:版本选择、安装细节和正版授权方式

4.1 社区版还是专业版:先看需求再决定

PyCharm 下载页面有一个下拉菜单,你可以切换 Windows、macOS、Linux。下方会有两个下载按钮:Community(社区版)和 Professional(专业版)。

我做了一张简单对比表,方便你根据自己的情况判断:

对比项Community 社区版Professional 专业版
价格免费开源商业收费
代码编写、补全、调试完整支持完整支持
数据分析、爬虫、学习项目够用够用
Django/Flask 等 Web 开发基本功能完整支持
数据库管理工具不包含包含
适合人群Python 初学者、数据分析入门Web 全栈、企业开发者

如果你是学生、教师,或者正在校学习,可以申请 JetBrains 教育授权,免费使用专业版。学生申请入口在 JetBrains 官网的 Students 页面,用学校邮箱注册即可,审核通过后按邮件里的步骤激活,完全合法。

如果只是自学编程,直接下载 Community 版就好,后面不需要承担任何授权成本。

提醒:网上搜索“PyCharm 激活码”“破解版”很容易踩到雷。破解工具多半携带恶意代码,泄露个人资料的案例不少见。正规渠道的社区版免费、专业版有试用也有教育授权,完全没有必要冒这个风险。

4.2 PyCharm 安装过程详解

PyCharm 本身也是一个安装向导,操作比 Anaconda 还简单:

  • 双击下载好的安装包,点 Next;
  • 选择安装路径。同样建议目录里不要出现中文,默认路径C:\Program Files\JetBrains\PyCharm Community Edition x.x.x就行;
  • Installation Options 安装选项:建议勾选“Create Desktop Shortcut(创建桌面快捷方式)”。其他如“Update PATH variable”“Update context menu”可以按需勾选,对新手来说不勾也行,不影响使用;
  • 点 Install 等待安装完成;
  • 安装完成后点 Finish,第一次启动时勾选“Do not import settings(不导入设置)”,点 OK。

首次启动后,PyCharm 会让你选择界面主题,选一个喜欢的就行,之后可以随时在设置里改。到这里 PyCharm 安装完毕,但还差最关键的最后一步:让它和 Anaconda 建立连接。

4.3 安装过程中的语言与插件设置

很多新手会问:PyCharm 能不能设置成中文?能。打开 PyCharm,进入Settings → Plugins,在 Marketplace 搜索框输入“Chinese Language Pack”,找到 JetBrains 官方的中文语言包插件,点击 Install 安装,重启 IDE 后界面就是中文的了。

需要提醒的是,我下面第五章和第六章提到的菜单名称,会同时给出英文和中文对照,因为不同插件的汉化程度不同,照着关键词找就能对得上。

5. 关键一步:让 PyCharm 找到 Anaconda 里的 Python 解释器

5.1 新建项目时如何选择解释器

打开 PyCharm,点击New Project。你会看到一个叫 "Location" 的输入框,这是项目存放路径,同样不要有中文,建议单独建一个文件夹,比如D:\PythonProjects\first_project

接下来是核心操作,在 “Interpreter” 相关区域,默认是 "Use Virtualenv",需要手动切换或者点 “Add Interpreter”:

  1. 选择Conda Environment
  2. 勾选Use existing environment(使用已有环境);
  3. 在环境列表里选择base,或者你之前创建好的虚拟环境;
  4. 如果 PyCharm 没有自动识别 conda 可执行文件,点击右侧浏览按钮,找到C:\Users\你的用户名\anaconda3\Scripts\conda.exe
  5. 点 OK。

设置完成后,点击 Create 创建项目。此时 PyCharm 底部状态栏会显示当前解释器路径,通常长这样:Python 3.x (base) ~/anaconda3/bin/python.exe

5.2 已有项目怎么切换解释器

如果你已经创建了项目,但解释器配错了,不需要重新建项目。进入File → Settings → Project: 你的项目名 → Python Interpreter,点右侧齿轮图标,选择Add Interpreter → Conda Environment,后续操作同上一个步骤。

还有一种更快的入口:在 PyCharm 右下角的状态栏,会有一个显示 Python 版本的地方,点击它会直接弹出解释器管理菜单,选Interpreter Settings就能进入同一个设置页面。

5.3 验证解释器是否配置成功

配置完之后,先跑一段最基础的代码验证。在项目窗口里右键点击项目文件夹 →New → Python File,输入文件名hello,写出下面这段代码:

import sys print(sys.executable) print("配置成功,解释器路径见上方输出")

然后点击右上角的绿色运行三角按钮。如果下方运行面板输出了一个完整的 python.exe 路径,并且包含 anaconda3 字样,说明 PyCharm 已经正确连上了 Anaconda。

接着再试一下导入第三方库:

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

Anaconda 预装了这些库,所以应该能正常输出版本号。如果这里提示ModuleNotFoundError: No module named 'numpy',多半是解释器选错了,回去重新检查第五章的配置步骤。

注意:很多人会把 PyCharm 的“终端 Terminal”和“Python 控制台 Python Console”混在一起。Terminal 是电脑系统的命令行窗口,Python Console 是交互式 Python 环境。大部分安装配置操作都在 Terminal 里完成,运行代码则在编辑区里写好后点运行按钮,两者分工不同,别搞混。

6. 跑通第一个项目:虚拟环境命令、镜像源配置和常见报错自救

6.1 conda 常用命令:今天先掌握这六个就够

Anaconda 装好之后,日常用到的命令其实不多。打开 Anaconda Prompt,或者 PyCharm 自带的 Terminal(前提是已经配置好 conda),逐个掌握下面这些命令:

创建虚拟环境:

conda create -n myenv python=3.10 -y

-n后面是环境名,这里叫myenv,你可以随便改名。python=3.10指定环境内的 Python 版本。-y表示遇到确认提示自动选择 yes,不用手动回车。

激活和退出虚拟环境:

conda activate myenv conda deactivate

激活后,命令行开头会变成(myenv),这就说明操作的是虚拟环境内的 Python,不会影响 base 环境。

查看已有环境列表:

conda env list

删除某个环境:

conda remove -n myenv --all

安装第三方包:

conda install requests # 或者 pip install requests

这两种方式都行。区别是 conda 从 Anaconda 官方仓库下载,pip 从 Python 官方仓库(PyPI)下载。一般优先用 conda,conda 上没有的包再用 pip。注意先激活目标环境再安装,装错环境的坑几乎人人踩过。

6.2 国内用户提速:conda 镜像源配置

Anaconda 默认从国外服务器下载包,在国内经常慢到离谱,出现CondaHTTPError是很常见的事。解决方案是换成国内高校维护的镜像源。

在 Anaconda Prompt 里执行下面两条命令:

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --set show_channel_urls yes

第一条添加镜像源,第二条让 conda 显示下载来源,方便你确认生效。配置完成后,再安装包就能明显感觉到速度提升。如果哪天想恢复官方源,执行:

conda config --remove-key channels

6.3 常见报错自查表

根据我见过的大量新手提问,把最高频的四个坑放在这里,你可以直接对照排查。

报错信息出现原因解决方法
conda 不是内部或外部命令Anaconda 未加入系统 PATH,或安装时未勾选相应选项用开始菜单的 Anaconda Prompt 操作,不用普通 cmd;或者手动添加环境变量
CondaHTTPError / HTTP 000 CONNECTION FAILED网络无法访问默认源按 6.2 节配置国内镜像源
ModuleNotFoundError: No module named 'xxx'当前虚拟环境里没装这个包,或解释器选错环境conda activate 对应环境,再pip install xxx;确认 PyCharm 解释器指向这个环境
Microsoft Visual C++ 14.0 is required某些包需要从源码编译,缺少 C++ 编译工具优先用conda install安装已编译好的版本;若仍需源码安装,可安装微软官方Microsoft C++ Build Tools,安装时应选中“使用 C++ 的桌面开发”工作负载

第四行那个Microsoft Visual C++ 14.0报错,是不少人在pip install一些偏门包时遇到的。大多数情况下,你先试试conda install同一名称的包,基本能绕开编译问题。绕不开再补装编译工具,不要第一反应就去下大型 SDK,浪费时间和磁盘空间。

6.4 报错排查的完整思路

遇到报错别急着复制粘贴去搜索,先按这个顺序走一遍:

第一步,看报错来自哪里。PyCharm 底部有不同的窗口标签,Run窗口报错是运行时的错,Terminal窗口报错是命令行的错,Python Console报错是交互环境的错。先确认出错的位置。

第二步,看关键词。所有报错里都有一行最关键的信息,比如ModuleNotFoundErrorconda is not recognizedPermission denied。把这几个关键词抄下来,再去搜索框搜,比整段直接复制更精准。

第三步,回到环境思路。绝大多数新手问题都指向同一个根源:当前操作的地方,用的不是你以为的那个解释器。比如你在 PyCharm 的 Terminal 里敲命令,但它实际调用的可能是系统 Python,而不是 Anaconda 的 Python。这时候执行一行代码确认:

where python

如果输出结果里出现了多个路径,并且第一个不是你想要的 Anaconda 路径,就说明 PATH 优先级出了问题。最简单的修复方式还是用 Anaconda Prompt,或者每次打开 PyCharm 之前先用 Anaconda Prompt 激活过一次环境。

写在最后:我的安装习惯和几点心得

这三四年里我帮不少人远程看过环境问题,最深的体会是:安装软件本身不难,难的是装完之后你不知道它为什么能跑、也不知道它哪天突然不能跑。所以我的建议是从一开始就不要当“只会点下一步的人”,每装一个软件之前,先问自己三个问题:它负责什么?它的解释器在哪?它和旁边软件会不会抢同一个东西?

我个人会先装 Anaconda,再装 PyCharm,这个顺序能让 PyCharm 自动识别到 conda 环境,少一步手动配置。日常管理环境时,所有 conda 命令都在 Anaconda Prompt 里执行,写代码和调试则在 PyCharm 里进行,两边互不干扰。

还有一个小技巧分享给你:每次创建一个新项目都新建一个虚拟环境,不要永远只用 base。虽然前期会多敲几行命令,但等到你的项目越来越多,就会感谢这种“一个项目一个环境”的习惯。希望这篇教程能帮你顺利搭好第一套 Python 开发环境,少走一点我当年走过的弯路。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询