拓十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

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

2023版Anaconda与PyCharm环境配置完全指南:从安装到虚拟环境

2023版Anaconda与PyCharm环境配置完全指南:从安装到虚拟环境

写代码的第一步,往往不是敲代码,而是先把环境配置明白。我自己带过不少新人,发现十个里有八个卡在同一个地方:装好了 Anaconda,也装了 PyCharm,但两者就是接不上,要么 import 不到包,要么版本冲突,最后对着报错一脸懵。这篇文章就专门把 2023 版 Anaconda 和 PyCharm 的下载、安装、环境配置完整捋一遍,告诉大家每一步该选什么、为什么这么选,也会把我踩过的一些坑直接摆出来。如果你正准备从零搭建 Python 开发环境,或者已经被环境问题折腾到头大,照着这套流程走一遍基本就能顺下来。

1. 为什么是 Anaconda + PyCharm 这个组合

1.1 新手最容易踩的环境坑

Python 本身并不复杂,真正让人头大的是它周边的依赖环境。今天要装 NumPy 做数值计算,明天要装 pandas 处理数据,后天可能还要装 PyTorch 跑模型,这些库和库之间有版本依赖关系,还偏偏不总是兼容。有些库只支持 Python 3.8,有些库在 Python 3.10 上才能正常编译,你要是图省事把包全部一股脑装进同一个环境,等到项目之间版本冲突时,你就知道什么叫"牵一发而动全身"了。

更常见的情况是"装包装到一半就报错"。同一套 Python,有的包从官方源下载慢得像蜗牛,一个小时都装不完;有的包在 Windows 上编译还需要 Visual C++ 工具链,缺了就直接抛 Microsoft Visual C++ 14.0 is required,新手看到这种报错基本都是两眼一抹黑,不知道到底缺了什么,也不知道该去哪里补。

这些问题本质上是同一个痛点:缺少一个"能隔离、能控制、能复现"的环境管理方案。把 Python 解释器、第三方包、项目依赖全部打包进一个独立空间,互不干扰,这才是正经解法。

1.2 Conda 管环境,PyCharm 管代码

Anaconda 做的事情,就是把 Python 解释器、常用的科学计算包(NumPy、pandas、Matplotlib 等)还有 conda 这个包管理器打包到一起。它最大的价值是虚拟环境这个概念:你可以为每个项目单独开一个独立环境,互相隔离。理解虚拟环境有一个特别生活化的类比——它就是给每个项目安排了一间隔音的房间,你在里面怎么折腾都行,装什么、删什么,都不会影响房间外面的世界,也不怕隔壁邻居的依赖包跟你的冲突。

PyCharm 则负责"写代码"这半边。它是一个完整的集成开发环境,提供了代码补全、调试断点、单元测试、版本控制面板、数据库工具等一系列开箱即用的能力。它本身不自带 Python,需要你给它指定一个已存在的解释器——这个特性正好和 Anaconda 形成完美配合。一个管环境,一个管编辑,两者搭配,比"裸装 Python + 记事本 + 手动配置各种插件"这条路要省心得多。

2. Anaconda 的下载与安装(2023版实操)

2.1 下载渠道与版本选择

Anaconda 官方网站是 anaconda.com,进入之后在 Products 菜单里找到 Distribution 页面,就能看到下载入口。页面会根据你的操作系统自动推荐对应安装包,Windows 用户直接选 64-Bit Graphical Installer。现在的电脑基本都是 64 位系统,除非你的机器非常老,否则不要碰 32 位版本。

2023 年发布的 Anaconda 安装包,默认附带的 Python 版本是 3.11。如果你有特殊兼容需求,比如公司项目还在用老框架,只支持 Python 3.8/3.9,那就需要去历史版本页面找对应的安装包。历史版本地址在清华镜像里也有收录:mirrors.tuna.tsinghua.edu.cn/anaconda/archive/,这是国内下载速度最快、最稳定的渠道之一。官网直连经常只有几百 KB/s,换到镜像源之后基本能跑满你家带宽,下载一个 600MB 的安装包也就是几分钟的事。

这里多说一句,Anaconda 也提供精简版的 Miniconda,只会装 conda 和 Python,其他包按需安装。如果你对磁盘空间敏感,或者偏好"极简起步",可以选 Miniconda;但如果你是新手,我还是推荐完整版 Anaconda,开箱即用,省去后面逐个装包的折腾。

2.2 Windows 安装过程的关键选项

拿到安装包后双击运行,前面的步骤基本都是"Next"、"I Agree",真正需要你拿主意的是后面两个选项。

第一个是安装路径。我强烈建议不要装到默认的 C 盘用户目录,也别安装在带空格的目录(比如 Program Files)。Anaconda 里有些底层组件对路径中的空格和权限比较敏感,装在 Program Files 偶尔会触发权限问题,查起来特别莫名其妙。我自己的习惯是装在 D 盘,比如 D:\Anaconda3,路径简洁,项目文件多了也不至于把系统盘塞满。

第二个是 "Add Anaconda3 to my PATH environment variable" 这个勾选项。勾上它,conda 命令会被写入系统全局环境变量,后续在任意终端窗口里都能直接用;不勾的话,你只能用开始菜单里的 Anaconda Prompt 来操作 conda。看上去勾上更方便,但如果你电脑里已经装了别的 Python,勾选后可能出现命令冲突,终端里的 python 到底指向谁就看 PATH 顺序了。

我的建议是:纯新手、电脑上没有其他 Python,可以勾;机器上已经有别的 Python 环境,就别勾,用 Anaconda Prompt 工作就够了。不要贪这个方便,给后面埋雷。

2.3 环境变量和安装验证

安装完成后,打开命令行(cmd 或 PowerShell),输入 conda --version,如果输出 conda 4.x.x 这样的结果,说明 conda 已经成功进入 PATH。如果提示"conda 不是内部或外部命令",先别慌,通常是两种情况:安装时没勾 PATH 选项,或者环境变量还没刷新。重新开一个终端窗口再试一次,不行就去系统环境变量里手动检查。

如果你想手动添加环境变量,在"此电脑 -> 属性 -> 高级系统设置 -> 环境变量"里,找到 Path 变量,把下面三个路径追加进去(路径以你的实际安装位置为准):

  • D:\Anaconda3
  • D:\Anaconda3\Scripts
  • D:\Anaconda3\Library\bin

保存后重开终端。验证是否配置成功,三步走:conda --version 看 conda 版本,python --version 看 Python 版本,再执行 python -c "import numpy; print(numpy.version)" 看看常见库能不能正常导入。这三条命令全部通过,说明 Anaconda 环境基本立住了。

3. PyCharm 的下载与安装(2023版实操)

3.1 社区版和专业版到底怎么选

PyCharm 分为两个版本:Community(社区版)和 Professional(专业版)。社区版免费开源,日常 Python 开发、数据分析、脚本编写、Django 类 Web 项目都够用;专业版收费,额外提供数据库工具、前端框架支持、远程开发、Docker 集成等企业级功能。

很多新手一上来就搜"PyCharm 激活码",实际上真没必要。社区版连账号都不需要注册,下载完直接使用,完全没有激活这回事。网上那些"永久激活码"大多来路不明,有的绑定老版本,有的夹杂私货,安全风险很高,我建议直接无视。学习阶段老老实实用 Community 版,等以后确实需要专业版的数据库工具或远程开发了,再考虑正式付费订阅,这才是干净、省心、合规的路子。

3.2 安装流程与首次启动配置

PyCharm 官网是 jetbrains.com/pycharm,进入后点 Download,页面默认展示专业版下载按钮,往下拉就能看到 Community 版的下载入口。Windows 安装包是 exe 格式,双击后一路 Next 即可。

安装界面里有几个附加选项,值得说一下:

  • 创建桌面快捷方式:按个人习惯。
  • 添加到右键菜单:建议勾上,之后在文件夹里右键 .py 文件可以直接用 PyCharm 打开,方便。
  • 关联 .py 文件:建议勾上,双击 .py 文件默认用 PyCharm 打开。
  • 更新 PATH 变量:不建议勾选,PyCharm 自带命令行工具,不需要把整个 IDE 加进 PATH。

首次启动时,PyCharm 会询问是否导入旧配置,新机器直接选 Do not import settings。接下来是主题选择,Light 和 Darcula 二选一,我更习惯 Darcula 深色主题,长时间写代码对眼睛友好很多。再往后它会自动加载插件市场,国内网络环境下偶尔会卡一会儿,耐心等两分钟基本就过了,实在卡住了就检查网络或者先跳过插件初始化,进主界面后再手动处理。

3.3 汉化、字体与编码设置

2023 版 PyCharm 默认英文界面,想用中文的朋友可以到 Settings -> Plugins 市场里搜索 Chinese Language Pack,找到后点击 Install,安装完重启就是中文界面。注意这个插件需要联网下载,如果搜不到,大概率是网络问题,多试几次,或者确认一下 PyCharm 的代理设置是否正常。

除了汉化,我每装一个新环境还会顺手改两个设置。第一个是字体,Settings -> Editor -> Font 里可以调整编辑器的字体、字号和行距,JetBrains Mono 和 Consolas 都适合写代码,字号 14 或 15 是我比较舒服的配置。第二个是文件编码,Settings -> Editor -> File Encodings 里把 Global Encoding、Project Encoding、Properties Files 全部设为 UTF-8。不设置的话,写中文注释、打印中文内容都可能出现乱码,非常影响体验。

4. 把 Anaconda 接入 PyCharm(核心配置)

4.1 新项目里配置 Conda 解释器

打开 PyCharm,点击 New Project,左侧项目类型默认就是 Pure Python,重点是中间的 Python Interpreter 一栏。这里有两个选项:

第一个是 Existing,点后面的三个点,在弹出的窗口里找到 Anaconda 安装目录下的 python.exe,比如 D:\Anaconda3\python.exe。这种方式是把系统级的 base 环境作为解释器,简单直接,但也意味着所有项目共用同一个环境,时间长了还是会乱。

第二个是 New environment using,在后面的下拉框里选 Conda。PyCharm 会自动识别你安装好的 conda,并在 Locaton 里自动填好新环境路径,你只需要给环境起个名字、选一个 Python 版本就行。点 Create 之后,PyCharm 会创建一个独立的 conda 虚拟环境,以后这个项目装的包都在这个环境里,和其他项目互相隔离。

我推荐用第二种。你说不清未来会碰到哪些依赖冲突,把隔离的工作做在前面,后面一定少挨打。

4.2 理解 conda 虚拟环境的核心命令

虽然 PyCharm 的图形界面已经能覆盖大部分场景,但我还是建议你花十分钟把 conda 命令行学会。不是因为命令行更高级,而是理解了底层逻辑之后,你才能看懂图形界面到底在干什么。

打开 PyCharm 自带的 Terminal(终端),可以直接输入 conda 命令。最常用的核心命令就这几条:

# 创建名为 demo_env 的新环境,并指定 Python 版本为 3.11 conda create -n demo_env python=3.11 # 激活该环境 conda activate demo_env # 退出当前环境 conda deactivate # 查看当前环境安装了哪些包 conda list # 查看本机所有 conda 环境 conda env list

第一条命令创建环境时,conda 会自动解析并安装指定 Python 版本,这个过程会稍微等一会儿,取决于网络状况。激活环境后,终端提示符最前面会出现 (demo_env) 这样的前缀,这就是环境隔离生效的直观表现。你再看 PyCharm 里"新建环境、切换解释器"这些操作,本质就是这些命令的图形化封装,概念通了,界面只是个壳。

4.3 国内镜像源配置与下载加速

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 配置文件,以后下载包就会优先走镜像通道。装包速度通常是肉眼可见地提升,像 PyTorch、TensorFlow 这种几百 MB 的大包尤其明显。

如果你不想改全局配置,只是想临时让某一次安装走镜像源,可以这样用:

conda install numpy -c https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/

这种一次性指定通道的方式最灵活,适合只偶尔装包、不打算长期改动配置的场景。另外说一句,镜像源更新可能比官方源慢几个小时,偶尔遇到新发行的包在镜像里还找不到,不用慌,等半天或直接用官方源拉一次就行。

4.4 PyCharm 里装第三方包的正确姿势

配好镜像源之后,在 PyCharm 里装包就有两种主要方式:一种是在界面右侧或左下角的 Python Packages 窗口里搜索包名,点 Install;另一种是在 Terminal 里用命令行安装。

PyCharm 的 Python Packages 窗口适合"我大概知道要装什么,但想看看到底有哪些版本"的场景,图形界面检索直观,还能看到每个包的描述和版本号。但遇到依赖关系复杂的包,或者需要指定安装通道时,命令行更靠谱。

我自己的经验是:能用 conda 装的优先用 conda,比如 conda install pandas,因为 conda 会自动处理依赖关系;conda 源里没有的包,用 conda install 会提示找不到,这时候再切换到 pip install 补救。要注意的是,在同一环境里 pip 和 conda 混用偶尔会造成依赖管理混乱,所以原则是尽量少混,装完一个再装下一个,避免一次引入太多变动。

5. 高频报错与排查技巧

5.1 报错速查表

我在本地帮很多朋友修过环境问题,整理了一份高频报错速查表,覆盖了新手最容易撞上的几个坑:

报错信息常见原因解决方案
conda 不是内部或外部命令安装时没勾 PATH,或环境变量未生效手动添加环境变量或重开终端
Microsoft Visual C++ 14.0 is requiredWindows 缺少 C++ 编译工具链安装 Visual C++ Build Tools 或 Visual Studio 的 C++ 工作负载
ModuleNotFoundError: No module named 'xxx'包没有装进当前环境先确认当前激活环境,再重新安装对应包
PyCharm 运行时提示找不到解释器项目绑定的 Python 路径已失效到 Settings -> Project -> Python Interpreter 重新指定
终端里 conda 可用,PyCharm 终端里不可用环境变量设置后 PyCharm 未重启完全退出 PyCharm 再重新打开
conda 安装包速度极慢默认官方源网络不通畅配置国内镜像源,具体命令见前文

表格里的前三个问题是日常出现频率最高的。第一个本质是 PATH 问题,第二个说明 Windows 上编译型 Python 包需要系统级构建工具,第三个则是环境隔离观念没养成,包装到了 A 环境,代码却跑在 B 环境。

5.2 三个容易忽略的隐藏雷区

第一个雷区是"装包装错了环境"。我见过不少人打开 PyCharm 的终端就敲 pip install,系统提示 already installed,但代码里还是 import 不到,回头一看,pip 对应的是全局 Python,而项目使用的解释器是另一个 conda 环境。装包前可以先在终端执行 python -c "import sys; print(sys.executable)",把当前解释器的完整路径打印出来,确认没错再动手。

第二个雷区是 Anaconda 自带的 Python 和系统已有 Python 冲突。有些电脑出厂预装了 Python,或者用户之前自己装过。Anaconda 装完之后,在 cmd 里输入 python,到底打开的是哪一份解释器,完全取决于 PATH 里谁排在前面。用 where python 命令可以列出所有 Python 路径,你会看到有多个 python.exe 在排队。为了减少混乱,要么手动调整 PATH 顺序,要么从一开始就养成用 conda 环境的习惯,不要让命令行里的 python 成为不可控的变量。

第三个雷区是安装路径里的隐藏空格和中文。这部分在 2.2 里提过,但值得多说一句:很多旧版工具、编译脚本对路径空格特别敏感,哪怕你用的是 2023 年最新版,也不代表所有第三方包都跟得上。路径里没有中文、没有空格,简简单单的 D:\Anaconda3,是最省心的选择。

6. 环境配完之后,完整跑一个项目

6.1 一个最小项目完整演示

光说不练假把式。我拿一个最经典的入门场景走一遍完整流程:新建项目,用 pandas 读 CSV,做一行统计输出。

第一步,打开 PyCharm 新建项目,项目名随便起,比如 data_demo,解释器选择 Conda 方式,创建一个新环境 demo_env,Python 版本 3.11。创建过程会等一会儿,毕竟 conda 要先准备 Python 解释器。

第二步,打开 PyCharm 底部 Terminal,执行 conda activate demo_env,确保命令行处于项目环境中,然后执行 conda install pandas,等待安装完成。

第三步,在项目根目录新建一个 data.csv,随便写两行表头和数据。再新建 demo.py,输入下面这段代码:

import pandas as pd df = pd.read_csv("data.csv", encoding="utf-8") print(df.describe())

第四步,右键 demo.py 选择 Run,下面控制台会输出 pandas 计算出的统计信息。

这个流程里有意思的一点是:PyCharm 右键运行时,使用的是项目绑定的解释器,和命令行里是否 activate 无关。也就是说,只要在 UI 里把解释器配对了,命令行里那套激活操作就不是必须的。为什么还要学命令行?因为当你在网上找教程时,大部分资料默认你在用命令行格式,看到 conda activate 不至于一头雾水。

6.2 我对这套方案的实际建议

配置环境这件事,我的核心体会是:前面多花十分钟想清楚,后面少花十小时填坑。具体到我自己的使用习惯,可以总结成几条:

第一,每个项目单独一个 conda 环境,环境名用项目名缩写,比如项目叫 sales-analysis,环境名就写 sales,不要偷懒全部用 base。第二,项目根目录放一个 environment.yml 或者 requirements.txt,把依赖和版本号记录下来,环境坏了随时一条命令恢复。第三,不要盲目追求所有包都是最新版,很多项目"昨天还能跑今天突然不能"的原因,就是某个依赖被自动升级到了不兼容的版本。

如果想导出环境快照,可以用 conda env export -f environment.yml 生成一个完整的环境配置文件,之后要复现环境,只需要 conda env create -f environment.yml 一条命令搞定。这套流程配合版本管理一起用,换台新电脑也能快速把开发环境拉起来,不比手工重新逐个装包香吗?

最后再多说一句:初次配置环境时遇到报错,不要慌,把报错信息完整复制到搜索引擎里,大概率能找到答案。环境配置本来就是一个不断踩坑、然后不断填坑的过程,每填入一个坑,你对 Python 环境的理解就深一层。等哪一天你不再为环境问题发愁,或者能熟练帮别人排查 conda 报错的时候,这第一关你就算真正过了。

返回列表