Miniconda安装与Conda环境包管理命令实战教程
Conda 是一个跨 Windows、macOS 和 Linux 的包与环境管理工具,既能安装、运行、更新包及其依赖,也能创建、保存、加载和转换隔离环境。Anaconda 是面向科学计算的 Python 发行版,内置 conda、conda-build、Python 以及大量科学计算包;Miniconda 则是其轻量替代,默认只包含 conda、Python 和必要依赖。二者核心都是 Conda 系统,区别在于 Anaconda 预装套件多、硬盘占用更大,Miniconda 更节省空间,适合按需创建多个不同 Python 版本环境。Python 项目常共享包,也容易冲突。例如项目 P1 依赖 NumPy 1.2,P2 依赖 NumPy 1.3,同一环境安装两个版本就会产生问题。解决办法是为项目创建独立虚拟环境。常见工具有 Virtualenv、Conda、pipenv、venv。本文围绕 Miniconda 安装、Conda 环境管理、包管理、镜像配置、环境导入导出,以及 Mamba 和 JupyterLab 的使用展开。
1. Miniconda 下载与安装
从 Anaconda 官网下载 Miniconda 后按向导安装。安装过程中主要选项:
Just Me (recommended):只为我安装。
All Users (requires admin privileges):为所有用户安装,需要管理员权限。
选择安装路径。
Create shortcuts:创建快捷方式,建议保持勾选。
Register Miniconda3 as the system Python 3.14:注册为系统默认 Python,不勾选。
Clear the package cache upon completion:安装完成后清理缓存,想省空间可勾选。
安装完成后,打开 Anaconda Powershell Prompt,若命令行提示符前出现 (base),说明安装成功。可验证版本:
python -V
conda -V
也可以把下面三个路径加入 PATH 环境变量,然后在 cmd 中使用:
E:\\miniconda3
E:\\miniconda3\\Scripts
E:\\miniconda3\\Library\\bin
查看 conda 版本确认 Miniconda 是否可用:
conda --version
2. Conda 基本命令
常用信息与清理命令如下:
conda --help # 查看帮助
conda info # 查看 conda 信息
conda --version # 查看 conda 版本
conda update conda # 更新 Conda,慎用
conda clean --all # 清理不再需要的包和缓存
conda <指令> --help # 查看某个指令的详细帮助
conda config --show # 查看 conda 环境配置
conda clean -p # 清理没有安装的包
conda clean -t # 清理 tarball
3. 环境管理
创建环境时,可以指定环境名和 Python 版本,也可以同时指定初始包:
conda create --name <env_name> python=<version> ...
conda create --name myenv python=3.10
conda create -n myenv python=3.10
--name 可简写为 -n。激活与退出环境:
conda activate env_name
conda activate learn
conda deactivate
查看所有环境:
conda env list
删除环境:
conda remove --name <env_name> --all
conda remove --name learn --all
克隆环境:
conda create --name <new_env_name> --clone <old_env_name>
conda create --name myclone --clone myenv
4. 包管理
激活环境后,可用 conda 或 pip 安装包。不过在 Conda 环境中不建议优先使用 pip。安装包:
conda install numpy
conda install numpy=1.18
更新包:
conda update numpy
conda update --all
conda update --all 会更新所有包,需慎用。执行后 Conda 会对比版本并列出可升级项,同时提示相关包也会升级;出现 Proceed(/n)? 时输入 y 继续。
卸载包:
conda remove numpy
列出当前环境所有包,或查看指定包:
conda list
conda list pip
搜索可用包:
conda search package-name
5. 通道配置
Conda 通道是查找和下载软件包的源。默认通道由 Anaconda 维护,包通常经过测试;Conda-Forge 是社区驱动通道,包数量大、更新快,适合需要较新版本的场景;Bioconda 面向生物信息学与生物数据分析。
查看已配置通道:
conda config --show channels
添加通道:
conda config --add channels conda-forge
通道按顺序搜索,前面的优先。可以设置严格优先级:
conda config --set channel_priority strict
也可启用或禁用优先级:
conda config --set channel_priority true
conda config --set channel_priority false
删除通道:
conda config --remove channels channel-name
临时从指定通道安装,不修改全局配置:
conda install package-name -c conda-forge
若团队需要共享包或托管私有包,可以自建 Conda 通道,使用 HTTP 服务器如 NGINX、Apache,或 Anaconda 企业方案。
6. 设置国内镜像
默认 Conda 服务器下载慢时,可以配置清华 TUNA 等镜像。方法一是命令行添加:
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 --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/pro
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/msys2
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/menpo
conda config --set show_channel_urls yes
添加后确认顺序:
conda config --show channels
方法二是修改配置文件。Linux/macOS 为 ~/.condarc,Windows 为 C:\\Users\\<用户名>\\.condarc。Windows 不能直接创建 .condarc 时,可先执行:
conda config --set show_channel_urls yes
生成文件后再修改。配置示例:
channels:
- defaults
show_channel_urls: true
default_channels:
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2
custom_channels:
conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
deepmodeling: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/
然后清理索引缓存,确保使用镜像索引:
conda clean -i
可安装包测试:
conda install numpy
观察输出,确认包从镜像 URL 下载。
7. 环境导入与导出
导出当前环境为 YAML:
conda env export > environment.yml
从 YAML 创建环境:
conda env create -f environment.yml
8. PyCharm 中使用 Conda 环境
先创建项目所需虚拟环境:
conda create -n llamaindex-rag python=3.10
创建项目时选择“自定义环境”,类型选 Conda,环境选 llamaindex-rag,然后创建。若项目还需要其他依赖,可到 Conda Powershell Prompt 中激活 llamaindex-rag,再用 pip 安装依赖。
9. Mamba 使用
Mamba 是管理 Conda 环境和包的开源工具,目标是解决 Conda 处理大型环境时的速度和性能问题。它与 Conda 兼容,使用高效 C++ 库进行依赖解析,支持并行下载安装,提供更直观的输出和进度条,几乎可以直接用 mamba 替换 conda 命令。
在已有 Conda 环境中安装 Mamba:
conda activate myenv
conda install mamba -n base -c conda-forge
-n base 表示安装到 base 环境,这样可以在任何环境中使用 Mamba。常见替换:
mamba create --name myenv python=3.8
conda activate myenv
mamba install numpy
mamba update numpy
mamba remove numpy
mamba update --all
Mamba 的优势是速度快、并行下载效率高、兼容 Conda 生态;局限是相对较新,某些边缘情况下可能不如 Conda 稳定,社区成熟度也不如 Conda。
10. JupyterLab 使用
JupyterLab 是基于 Web 的交互式开发环境,面向 notebooks、代码和数据,界面可配置,模块化设计支持扩展,常用于数据科学、科学计算、计算新闻和机器学习流程。使用 pip 安装:
pip install jupyterlab
如果使用 conda 或 mamba 安装 JupyterLab,建议安装后启动:
jupyter lab
整体来看,Conda 的核心价值是用环境隔离解决依赖冲突,用包管理统一安装、更新和卸载。实际使用中,建议为每个项目单独创建环境,用 environment.yml 记录依赖,用国内镜像加速下载;面对复杂依赖或大型环境时,可尝试用 Mamba 替代 Conda 执行安装和更新命令。
Re: Miniconda安装与Conda环境包管理命令实战教程
这篇整理得很清楚,适合当作 Miniconda 上手速查。Miniconda 和 Anaconda 的区别、安装时哪些选项该勾选、把三个路径加进 PATH,以及创建激活删除克隆环境这些步骤都很实用。特别是提醒 conda update conda 和 conda update --all 要慎用,还有 Conda 环境里不要优先用 pip,这些对新手很关键。通道优先级和临时用 -c 指定通道也讲得明白,strict 模式我准备按你的说法试一下。国内镜像部分好像还没写完,期待补全后这篇就更完整了。感谢分享。Re: Miniconda安装与Conda环境包管理命令实战教程
楼主整理得挺全的,Miniconda 和 Anaconda 的区别、安装时那几个勾选项、环境创建激活删除克隆、包安装更新卸载、通道优先级这些都很实用。尤其提醒 conda update --all 慎用、Conda 环境里不优先用 pip,这两点很多人容易踩坑。base 环境最好只留 conda 和必要工具,项目都单独建环境,后面迁移或复现会省心很多。你提到后面还有镜像配置、环境导入导出、Mamba 和 JupyterLab,首帖好像到“默认 Cond”就断了,期待补全,特别是国内镜像和 environment.yml 导出恢复那部分。感谢分享,先收藏了。Re: Miniconda安装与Conda环境包管理命令实战教程
感谢分享,写得很系统。Miniconda 和 Anaconda 的区别、安装时哪些选项建议勾选或不勾选、以及为什么要给不同项目建独立环境,这几块对刚上手的人很友好。命令部分从 conda info、create、activate、deactivate 到 install、update、remove、list、search 都列出来了,照着敲基本能跑通。通道配置和 channel_priority 的说明也挺清楚,尤其临时用 -c 指定通道这个点很实用。不过最后国内镜像部分好像只到“默认 Cond”就断了,如果方便的话期待补全后续内容。
页:
[1]