尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

Anaconda+PyCharm从零搭建Python开发环境:原理、配置与避坑指南

Anaconda+PyCharm从零搭建Python开发环境:原理、配置与避坑指南 最近很多新手问的最多的不是“Python 怎么学”而是“Python 环境怎么装”。很多教程把 Anaconda 和 PyCharm 分开写装完 A 发现 B 配不上配完 B 发现 conda 命令又报错。这次我们直接串一条线从 Anaconda 下载安装、环境变量配置、conda 国内源配置、虚拟环境创建到 PyCharm 下载安装和解释器绑定一次性讲透。文章不预设任何编程基础只要你电脑能双击 exe就可以跟着装完。这套组合定位很清晰Anaconda 管 Python 运行时和包管理conda解决“装了不知道装到哪”“包冲突不敢动”的问题。PyCharm 管代码编写、调试和项目文件解决“写代码只能用记事本”的尴尬。两者通过解释器Interpreter绑定PyCharm 里的项目默认使用 Anaconda 里指定的 Python 版本。本文会演示Anaconda 的下载、安装和环境变量配置。conda 换国内源和虚拟环境创建。PyCharm 的下载、安装和 Anaconda 解释器配置。用一段 Python 脚本验证整套环境是否可用。1. 核心能力速览先给一张表格快速说清楚这套环境到底要干什么。项目说明教程定位Python 开发环境从零搭建涉及软件Anaconda、PyCharm Community / Professional核心组件conda、Python 解释器、pip、虚拟环境适用人群Python 零基础入门、数据分析、机器学习、Web 后端初学者操作系统Windows 10/11、macOS、Linux硬件要求普通办公电脑即可建议内存 8G 以上磁盘预留 10G 以上必备技能能双击安装包、能复制粘贴命令难度等级入门级是否涉及 API本文是环境配置教学不涉及具体服务接口是否涉及批量任务本文不做批量任务开发但环境就绪后可支持这套环境对电脑性能几乎没有门槛重点是安装过程里的几个关键选项别选错以及 conda 源要提前配置好。下面我们按顺序来。2. 适用场景与使用边界Anaconda 是一个集成了 conda 包管理器、Python 解释器和常用科学计算库的发行版。安装它相当于一次性把 Python 运行时和数据分析基础库比如 NumPy、Pandas、Matplotlib都装好不用再一个个手动下载。PyCharm 是 JetBrains 出的 Python IDE主要用于代码编写、代码补全、调试和项目文件管理。这套环境适合以下人和场景Python 完全零基础想先跑起来一个脚本不折腾底层细节。数据分析和机器学习方向需要经常装 NumPy、Pandas、scikit-learn 这类库。同一台机器需要同时维护多个 Python 版本或不同项目依赖conda 虚拟环境可以隔离。写课程作业、做毕业设计需要在一台新电脑上快速搭建开发环境。不适用或需要特别注意的场景如果只是想快速验证一段代码不打算长期做 Python 开发那么直接装一个精简 Python 甚至用在线编译器就够Anaconda 属于“全家桶”安装体积较大。如果项目已经强制要求使用某个 Python 版本而 Anaconda 默认版本不满足需要在虚拟环境里手动指定版本。安装第三方包时一定要确认包名正确、来源可信。从互联网下载安装包时建议核对官方校验值不要执行来路不明的 .exe 或 .sh 脚本。涉及网络请求、爬虫、数据处理时应遵守目标平台的条款不采集个人隐私数据不进行非法用途。3. 环境准备与前置条件在开始安装之前先确认三个东西操作系统、磁盘空间、网络源。3.1 操作系统与硬件Windows 10/11 是本文演示的主要系统。macOS 和 Linux 的安装逻辑类似主要区别在安装包格式和 conda 初始化命令。硬件方面普通办公电脑即可。Anaconda 安装后大约占 3 到 5G 磁盘空间PyCharm 安装后再占 1 到 2G后续创建虚拟环境和安装包还会继续增加空间。建议至少预留 10G 空闲磁盘避免用到一半磁盘满了。内存建议 8G 以上。安装环境本身对内存要求不高但后续用 PyCharm 打开大项目、跑数据分析代码时内存太小会明显卡顿。3.2 下载 Anaconda这里只说官方渠道安装包避免某些转链或第三方打包版本里被植入额外文件。Anaconda 在 Windows、macOS、Linux 都有对应安装包。下载时注意选择对应系统版本不要下载成 Linux 包在 Windows 上用。如果官网下载速度慢可以考虑使用国内镜像站提供的安装包。以清华 TUNA 镜像为例镜像站里保留了 Anaconda 官方安装包的完整副本进入镜像站的 installers 目录后根据系统选择对应文件即可。这里不贴具体 URL因为镜像路径会更新建议去搜索引擎搜“anaconda 清华镜像”进入镜像站后再选择文件。更稳妥的判断是优先使用 Anaconda 官网或国内高校镜像站下载完成后检查文件来源和大小是否正常。3.3 下载 PyCharmPyCharm 分两个版本Community社区版免费适合 Python 基础学习和日常脚本开发本文使用社区版即可。Professional专业版收费提供 Django/Flask 等 Web 框架支持、数据库工具等适合 Web 后端开发。搜“PyCharm 官网”进入 JetBrains 官网选择 Community 版本下载即可。安装时可以装在默认路径也可以自定义路径这里建议路径中不要有中文和空格避免个别工具链在识别路径时出问题。3.4 网络准备Anaconda 安装完成后第一次使用 conda 安装包时默认走的是官方源国内网络下载速度可能很慢甚至出现连接超时。所以第 5 节会专门配置国内镜像源。这一步先有个概念就行。4. Anaconda 下载与安装部署4.1 Windows 安装步骤双击下载好的 Anaconda 安装包一路按照界面提示操作即可但有几步需要特别注意。安装界面选择 Next。License Agreement 界面点击 I Agree。Select Installation Type 界面选择 Just Me推荐。除非你有多用户共用电脑的需求否则不要选 All Users避免权限问题。选择安装路径。默认路径一般是 C:\ProgramData\Anaconda3 或 C:\Users\用户名\anaconda3。建议安装到空间充足的盘符比如 D:\Anaconda3。如果 C 盘是固态硬盘D 盘是机械硬盘建议装在固态上conda 创建环境、导入包会明显更快。关键一步Advanced Installation Options。这里有“Add Anaconda3 to my PATH environment variable”和“Register Anaconda3 as my default Python 3.x”两个勾选项。网上很多教程会让你勾选 Add to PATH理由是安装后 conda 命令可以直接在 CMD 中使用。但更稳妥的做法是不勾选 Add to PATH安装完成后手动把 conda 所在目录加入环境变量。原因是 Anaconda 自带的 Python 环境里可能包含一些只适用于 conda 环境的包把它直接设为系统 PATH 里的 Python有可能和你以后装的 MiniConda、系统自带 Python 或其他工具产生冲突。如果你完全不想动环境变量也可以勾选 Add to PATH很多新手也是这样装完能用。这里给出的建议是“手动配置更可控”选哪种都不影响运行关键是后续知道配置在哪里。“Register Anaconda3 as my default Python”建议勾选这是让 Anaconda 的 Python 作为 Windows 系统默认 Python 的开关勾上以后其他程序调用 python 时基本都会走 Anaconda。点击 Install等待安装进度条跑完。安装完成后开始菜单会出现“Anaconda3”文件夹里面有 Anaconda Prompt、Jupyter Notebook、Spyder 等入口。最常用的是 Anaconda Prompt它是一个带 conda 环境变量的终端窗口后面所有 conda 命令都在里面运行。4.2 验证 Anaconda 安装打开 Windows 开始菜单找到 Anaconda Prompt点击运行。输入conda --version如果输出类似conda 23.x.x说明 conda 安装成功。再输入python --version如果输出类似Python 3.x.x说明 Anaconda 自带的 Python 解释器已经被调用。这里有一个容易困惑的点直接双击开始菜单里的 Python 快捷方式和在 Anaconda Prompt 里输入 python看到的是同一个解释器但环境变量不同。后续使用 PyCharm 时我们会在设置里显式指定解释器路径不依赖系统命令所以这一步的验证目的是确认 conda 命令可用。4.3 配置 PATH 环境变量可选如果没有勾选 Add to PATH现在可以手动把 conda 相关目录加进系统环境变量。在 Windows 搜索“环境变量”打开“编辑系统环境变量”点击“环境变量”在“系统变量”中找到 Path点击“编辑”然后“新建”把下面三个路径添加进去路径根据你的 Anaconda 实际安装位置调整D:\Anaconda3 D:\Anaconda3\Scripts D:\Anaconda3\Library\bin保存后重新打开一个 CMD 窗口输入conda --version验证。如果还是提示“conda 不是内部或外部命令”说明路径没有写对再检查一遍有没有拼错、目录是否存在。这里还要提醒手动加 PATH 后系统的 Python 命令很有可能优先指向 Anaconda。如果你以前装过别的 Python建议在 CMD 里执行where python确认当前 python 到底指向哪一个避免项目跑错解释器。4.4 macOS / Linux 安装说明macOS 和 Linux 的安装逻辑一样都是拿到官方安装脚本后执行。在终端中进入安装包所在目录执行bash Anaconda3-xxx-Linux-x86_64.sh这里xxx是实际版本号需要替换为你下载的版本。安装过程中会提示按 Enter 继续输入 yes 确认许可协议最后询问是否初始化 conda选择 yes。安装完成后重新打开终端conda 命令就能生效。如果 conda 找不带可以执行conda init后重启终端。5. conda 环境配置换源、虚拟环境与包管理5.1 为什么换源Anaconda 的默认 conda 源在国外国内网络访问容易超时。换源后包下载走国内镜像速度会明显提升。在 Anaconda Prompt 中依次执行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 config --show channels如果输出里包含上面的镜像地址说明源已经切换。换源后如果遇到UnavailableInvalidChannel: HTTP 404 NOT FOUND for channel anaconda/pkgs/free这类报错最可能的原因是你之前或者某个教程把已经失效的pkgs/free、pkgs/msys、pkgs/r频道写进了配置文件而镜像站上这些目录已经不再同步或路径发生了变动。解决办法打开用户目录下的.condarc文件。Windows 路径一般是C:\Users\你的用户名\.condarc。直接删除或注释掉失效的 channel 行。只保留可用的频道例如channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ - defaults show_channel_urls: true保存后执行conda clean -i清除索引缓存再重新执行conda update --all验证。这个问题在很多新手电脑上都出现过原因基本都是旧配置文件里残留了已经失效的频道地址。5.2 创建虚拟环境conda 最重要的能力是虚拟环境隔离。不同项目可以使用不同 Python 版本和不同包版本互不干扰。创建一个 Python 3.9 的环境conda create -n py39 python3.9 -y其中py39是环境名称可以换成任意你喜欢的名字python3.9指定 Python 版本也可以换成 3.8、3.10、3.11 等取决于你的项目要求。激活环境conda activate py39激活后终端路径前面会出现(py39)字样代表当前正在使用这个虚拟环境。退出环境conda deactivate查看所有环境conda env list删除环境conda remove -n py39 --all5.3 使用 pip 安装包在激活的环境中可以直接用 pip 安装项目需要的包。以 pandas 和 requests 为例pip install pandas requests如果需要指定版本pip install pandas2.0.3这里版本号按实际需要替换比如 1.5.3、2.1.0 都可以。常用包管理命令# 查看当前环境所有已安装包 conda list # 更新某个包 pip install --upgrade pandas # 卸载某个包 pip uninstall pandas导出当前环境的依赖清单pip freeze requirements.txt以后在新机器上重建环境只需要pip install -r requirements.txt这样可以把环境配置的成果固化成文件方便换电脑或换环境时快速恢复。5.4 conda install 和 pip install 的区别很多新手会混用这两个命令简单说一下区别conda install由 conda 管理能自动解决包之间的依赖冲突同时会连带更新相关的底层库。但 conda 源里不是所有 Python 包都有。pip install来自 PyPI包源更全安装更快但它不会管理 conda 层面的依赖可能会覆盖掉某些包。日常建议能用 conda 装的就用 condaconda 源里没有的再用 pip。在同一个环境里最好不要频繁混用两种方式安装大量包否则依赖解析可能变得混乱。6. PyCharm 安装与配置 Anaconda 解释器6.1 安装 PyCharm下载 PyCharm Community 版本后运行安装包。主要注意两点Installation Options 界面勾选“Add Open Folder as Project”和“Create Desktop Shortcut”。安装路径同样建议不要含中文。安装完成后打开 PyCharm首次启动会要求选择主题和快捷键方案按个人习惯选择即可。6.2 新建项目并绑定解释器打开 PyCharm点击 New Project。在弹出的设置窗口里Location 是项目路径项目名会显示在这条路径的最后一段建议把它放到一个你自己找得到的目录里。Interpreter 区域选择“Previously configured interpreter”再点右侧的设置按钮选择 Add Interpreter - Add Local Interpreter。在 Add Local Interpreter 窗口中选择左侧Conda Environment右侧Existing environment - Interpreter点击右边的文件夹图标浏览到 Anaconda 安装目录下的 python.exe。如果你创建了虚拟环境则在envs\py39目录下找到 python.exe。例如D:\Anaconda3\envs\py39\python.exe没有虚拟环境时直接选择D:\Anaconda3\python.exe也可以但推荐使用独立虚拟环境避免 base 环境被装乱。6.3 在 PyCharm 里运行 Python 脚本配置好解释器后在项目目录下新建一个 Python 文件输入最简单的测试代码print(hello anaconda pycharm)右键点击文件选择 Run。如果下方控制台输出这行文字说明 PyCharm 已经成功连接到 Anaconda 的 Python 环境。如果之前已经从 conda 装好了 pandas在 PyCharm 中也可以直接导入import pandas as pd print(pd.__version__)这里能正常输出版本号说明包和解释器路径都正确。6.4 PyCharm 的 Terminal 与 conda 环境联动PyCharm 底部有一个 Terminal 面板它打开后默认会进入当前项目的虚拟环境。如果你在 PyCharm 里打开终端发现输入conda activate py39报错通常是因为 PyCharm 的 Shell 没有继承系统环境变量。解决办法确认在系统环境变量中已经配置了 conda 的 Scripts 目录。在 PyCharm 的设置里搜索 Terminal把 Shell path 设置为 cmd.exe 或 powershell.exe 的完整路径。重启 PyCharm 后再试。这个问题的本质和 CMD 里找不到 conda 命令是一样的根源都在 PATH 配置。7. 功能验证跑通一套 Python 环境测试用例环境装完不是终点能跑通常见场景才是关键。下面给一组验证脚本建议逐个运行用来判断整体环境是否真的可用。7.1 基础运行验证# 验证 Python 解释器 print(Python 解释器正常) print(1 2)预期输出Python 解释器正常 3如果这里直接报错说明解释器没有绑定成功回到上一节检查 PyCharm 的 Interpreter 配置。7.2 第三方包验证# 验证 pandas 和 numpy import numpy as np import pandas as pd arr np.array([1, 2, 3]) print(numpy:, arr * 2) df pd.DataFrame({name: [a, b], score: [90, 85]}) print(df)预期输出numpy: [2 4 6] name score 0 a 90 1 b 85如果提示 ModuleNotFoundError需要在当前环境里先安装包pip install numpy pandas7.3 文件操作验证# 验证文件读写 from pathlib import Path Path(test.txt).write_text(hello anaconda, encodingutf-8) content Path(test.txt).read_text(encodingutf-8) print(content)预期输出hello anaconda。7.4 网络请求验证这里演示用 requests 请求一个公开网页并打印状态码。示例仅用于学习实际项目中要关注目标网站的访问条款不要高频请求、不要抓取个人隐私信息。# 验证 requests import requests resp requests.get(https://example.com, timeout10) print(status_code:, resp.status_code)预期输出status_code: 200如果请求超时或状态码异常优先检查本机网络。7.5 综合环境自检脚本把下面代码保存为一个check_env.py一次运行可以同时验证多个维度。import sys import platform from pathlib import Path print(Python 版本:, sys.version) print(操作系统:, platform.platform()) print(当前解释器路径:, sys.executable) try: import numpy as np print(numpy 版本:, np.__version__) except ImportError: print(numpy 未安装) try: import pandas as pd print(pandas 版本:, pd.__version__) except ImportError: print(pandas 未安装) try: import requests print(requests 版本:, requests.__version__) except ImportError: print(requests 未安装) p Path(env_test.txt) p.write_text(ok, encodingutf-8) print(文件写入:, p.read_text(encodingutf-8))运行后如果“版本”和“文件写入”都正常输出说明 Python 解释器、第三方库、文件操作三条链路全部可用。整套环境到这里就算真正跑通了。8. 接口 API 与批量任务扩展说明本文是环境配置教学本身不直接提供接口服务也不会在这里带你写批量任务。但环境搭好以后下面的方向可以继续扩展。8.1 后续可以开发接口服务Python 环境就绪后最常见的走向是用 Flask 或 FastAPI 写一个 HTTP 接口。这里给一个最简示例展示环境就绪后做接口开发的基本样子。如果没有安装 Flaskpip install flask然后写一个app.pyfrom flask import Flask, jsonify app Flask(__name__) app.route(/ping) def ping(): return jsonify({message: pong}) if __name__ __main__: app.run(host127.0.0.1, port5000)运行后访问http://127.0.0.1:5000/ping可以看到接口返回 JSON。这个示例的目的是验证用 Anaconda 管理的环境中可以正常安装 Web 框架并启动本地服务。实际项目中的路由、参数校验、错误处理需要按业务再设计。8.2 批量任务方向环境就绪后批量任务可以从两个角度理解一种是从脚本层面做批量循环对一批文件或一批 URL 逐个执行相同逻辑用 Python 的循环、多进程或异步很容易实现。另一种是从任务调度层面做批量用scrapy爬虫框架、Celery分布式任务队列或者schedule定时任务库来安排大批量任务。如果你的方向是数据处理批量任务建议从pandas的向量化操作开始尽量不要用 for 循环一条一条处理大文件数据那样性能会差很多。如果你的方向是批量请求外部接口要记得加限速、失败重试和日志记录。这些内容属于进阶主题本文不展开但底层环境你已经具备可以直接接后续教程继续学。8.3 接口调试时的通用验证命令在已经跑通本地接口的情况下可以用 curl 快速验证curl http://127.0.0.1:5000/ping也可以用 Python 验证import requests r requests.get(http://127.0.0.1:5000/ping, timeout5) print(r.status_code) print(r.json())注意如果接口地址或参数不是这种形式需要按实际项目接口文档调整。9. 资源占用与性能观察环境配置完成后运行期主要观察两个软件的消耗Anaconda 目录占用的磁盘空间以及 PyCharm 打开项目后的内存占用。9.1 Anaconda 的磁盘占用Anaconda 默认包含 Python、conda、常用科学计算库安装完成后目录可能达到几 GB。每次创建虚拟环境又会新增一套 Python 解释器和基础包所以不要无限制地创建环境。建议一个项目用一个环境项目结束或不再使用后及时删除环境释放磁盘。用conda env list定期检查已有环境。大文件数据不要放在 Anaconda 目录或项目目录下单独建data文件夹。9.2 conda 安装包时的 CPU、磁盘与网络占用执行conda install或pip install时包管理器会大量解压写入文件CPU、磁盘、网络都会有明显消耗。如果安装大型库等待时间可能较长。观察方式打开任务管理器看 Python 相关进程的 CPU 和磁盘占用。如果长时间卡在 resolving 或下载 0%优先检查源是否可用、网络是否稳定。9.3 PyCharm 的内存占用PyCharm 是基于 JVM 的 IDE启动后通常会占用 1G 以上内存。如果电脑只有 8G 内存同时开浏览器和 PyCharm会有点紧张。建议观察 PyCharm 底部状态栏的内存占用。大型项目中关闭不需要的文件标签页。如果内存明显不足可以在 Help - Change Memory Settings 中调整最大堆内存但调大前先确认物理内存够用。打开项目后 PyCharm 会建立索引第一次打开会卡一段时间这是正常现象。9.4 降低环境资源占用的策略不需要用 Anaconda 全家桶时可以用 Miniconda它只包含 conda 和 Python按需创建环境占用空间小很多。base 环境尽量保持干净普通项目依赖放到独立虚拟环境里。定期执行conda clean --all清理下载缓存。conda clean --all这条命令会清理下载缓存降低磁盘占用不影响已安装的包。10. Anaconda 与 PyCharm 常见问题与排查方法汇总新手最容易遇到的报错和处理思路。问题现象可能原因排查方式解决方案安装完成后 conda 不是内部或外部命令未加入 PATH打开 CMD 执行where conda手动加入 Anaconda 的 Scripts 目录或重装时勾选 Add to PATH提示 python 找不到PATH 中 Python 冲突或未配置where python查看当前指向在 PyCharm 中显式指定解释器路径conda 报 UnavailableInvalidChannel HTTP 404配置文件里残留失效频道查看~/.condarc删除或注释掉失效 channel保留有效镜像后执行conda clean -iconda 下载包速度极慢未换源或源失效执行conda config --show channels配置清华或阿里云镜像PyCharm 里导入 pandas 报 ModuleNotFoundErrorPyCharm 绑定了解释器但不是当前环境查看 PyCharm Interpreter 设置切换到包含目标包的 conda 环境conda create 卡在 Solving environment源慢或包依赖冲突观察任务管理器是否卡在网络下载换源、减少包数量、耐心等待或换网络Windows 上双击安装包没有反应安装包
返回列表