Anaconda / Miniconda 安装与配置:从零到环境搭建的完整指南

张开发
2026/4/18 16:42:48 15 分钟阅读

分享文章

Anaconda / Miniconda 安装与配置:从零到环境搭建的完整指南
1. 为什么选择Anaconda/Miniconda刚接触Python数据科学的朋友们一定经常被各种依赖包冲突搞得焦头烂额。我刚开始用Python做机器学习项目时就遇到过tensorflow和pandas版本不兼容的问题重装了三遍系统才解决。后来发现了Anaconda这个神器就像找到了打开Python世界的正确方式。Anaconda和Miniconda本质上都是conda环境管理工具。Anaconda是全家桶版本预装了200多个科学计算常用包开箱即用Miniconda则是精简版只包含conda和Python基础环境更轻量灵活。我建议新手先用Anaconda避免自己装包的麻烦等熟悉后可以换Miniconda按需定制环境。这两个工具最厉害的地方在于环境隔离可以为每个项目创建独立环境比如同时维护TensorFlow 1.x和2.x项目包管理自动解决依赖冲突再也不用担心装了这个包那个包就不能用的问题跨平台Windows/Linux/macOS通用我在WSL里用的就是Miniconda2. 安装前的准备工作2.1 硬件与系统要求虽然Anaconda对配置要求不高但考虑到科学计算的需求建议至少4GB内存处理大型数据集建议8GB以上20GB可用磁盘空间Anaconda完整安装需要约3GB还要预留环境空间64位操作系统32位系统只能用老版本我曾在256GB的笔记本上同时维护过10多个conda环境后来发现把环境建在移动固态硬盘上也很稳定这对空间紧张的同学是个不错的解决方案。2.2 下载安装包官方下载地址Anacondahttps://www.anaconda.com/products/distributionMinicondahttps://docs.conda.io/en/latest/miniconda.html选择版本时要注意推荐Python 3.9或3.10版本太新的Python可能有些包还没适配根据系统选择正确的安装包后缀Windows: .exemacOS: .pkg 或 .shLinux: .sh我习惯用wget直接下载Linux版比如wget https://repo.anaconda.com/miniconda/Miniconda3-py39_23.1.0-1-Linux-x86_64.sh3. 详细安装步骤3.1 Linux/WSL安装过程以Miniconda为例安装过程其实很简单# 1. 给安装脚本添加执行权限 chmod x Miniconda3-latest-Linux-x86_64.sh # 2. 运行安装脚本 ./Miniconda3-latest-Linux-x86_64.sh安装过程中会遇到几个关键选择阅读许可证协议后输入yes安装路径建议用默认值通常是~/miniconda3。我有次改到/mnt目录下导致权限问题折腾了半天询问是否初始化conda时一定要选yes这样会自动配置环境变量安装完成后需要重新加载bash配置source ~/.bashrc验证安装是否成功conda --version # 应该显示类似 conda 23.1.0 的版本号3.2 Windows安装注意事项Windows用户直接双击.exe安装包但有几点要注意安装类型选Just Me除非你是系统管理员务必勾选Add Anaconda to my PATH environment variable不建议勾选Register Anaconda as my default Python可能影响已有Python项目安装完成后在开始菜单找到Anaconda Prompt这是专门为conda配置的命令行终端。4. 基础配置与优化4.1 配置国内镜像源conda默认源在国外下载速度很慢。配置清华源能极大提升体验conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ conda config --set show_channel_urls yes查看配置是否生效conda config --show channels4.2 常用conda命令速查这些是我每天都会用到的命令创建环境conda create -n 环境名 python3.9激活环境conda activate 环境名退出环境conda deactivate安装包conda install 包名比pip更能解决依赖冲突导出环境配置conda env export environment.yml根据yml文件复现环境conda env create -f environment.yml5. 创建你的第一个项目环境5.1 环境创建实战假设我们要做一个机器学习项目需要Python 3.9、pandas和scikit-learnconda create -n ml_project python3.9 pandas scikit-learn创建完成后激活环境conda activate ml_project你会发现命令行提示符前面多了(ml_project)表示已经进入该环境。这时安装的包都不会影响其他环境。5.2 环境管理技巧查看所有环境conda env list复制环境conda create -n 新环境名 --clone 旧环境名删除环境conda remove -n 环境名 --all分享环境配置导出environment.yml文件后可以发给队友重现相同环境我习惯为不同类型的项目创建基准环境比如base_py39只装Python 3.9和基础工具包data_science包含pandas/numpy/matplotlibdeep_learning包含pytorch/tensorflow6. 常见问题排查6.1 环境激活失败如果遇到conda: command not found通常是环境变量没配置好。检查~/.bashrc是否有类似内容export PATH/home/用户名/miniconda3/bin:$PATH然后执行source ~/.bashrc刷新配置。6.2 安装包冲突conda虽然能自动解决依赖但有时也会遇到无法解决的冲突。我的经验是先尝试conda update --all更新所有包创建新的干净环境重新安装对于特别难搞的包可以在该环境中用pip安装但不推荐混用conda和pip6.3 空间不足问题conda环境会占用不少空间定期清理很有必要# 清理无用的安装包 conda clean -p # 删除索引缓存等 conda clean -y --all对于长期不用的环境建议导出yml文件后删除环境本体需要时再重建。

更多文章