Conda 是一个开源的包、环境管理器,可以用于在同一个机器上创建不同的虚拟环境,安装不同Python 版本的软件包及其依赖,并能够在不同的虚拟环境之间切换
Conda常通过安装Anaconda/Miniconda来进行使用。一般使用Miniconda就够了。Miniconda 是 Anaconda 的简化版,仅包含 Conda 和 Python 基础环境,适合大多数用户
目录
[✅ 推荐方式:安装 Miniconda(轻量版,够用)](#✅ 推荐方式:安装 Miniconda(轻量版,够用))
[1. 安装 Miniconda](#1. 安装 Miniconda)
[2. 配置国内镜像源](#2. 配置国内镜像源)
[3. 初始化 Shell(重要!)](#3. 初始化 Shell(重要!))
[4. 验证安装](#4. 验证安装)
[5. 创建和管理虚拟环境](#5. 创建和管理虚拟环境)
[① 创建环境](#① 创建环境)
[② 激活环境](#② 激活环境)
[③ 关闭环境](#③ 关闭环境)
[④ 删除环境](#④ 删除环境)
[⑤ 克隆环境](#⑤ 克隆环境)
[6. 查询已存在的虚拟环境](#6. 查询已存在的虚拟环境)
[7. 虚拟环境切换](#7. 虚拟环境切换)
[8. 安装或删除库](#8. 安装或删除库)
[🚫 不推荐:直接安装 Anaconda](#🚫 不推荐:直接安装 Anaconda)
在 macOS 上通过 Homebrew 安装 Conda的步骤如下:
✅ 推荐方式:安装 Miniconda(轻量版,够用)
Miniconda 是 Conda 的最小化发行版,体积小,只包含 Python 和 Conda,后续需要再手动装包
如果没有安装Homebrew,可以参照这篇文章:Mac安装HomeBrew详细教程
1. 安装 Miniconda
bash
brew install --cask miniconda
⚠️注意 :从 2023 年起,
brew install miniconda
已被弃用,需使用--cask
。
2. 配置国内镜像源
bash
# 1.先清空旧频道,防止冲突
conda config --remove-key channels
# 2.依次添加国内清华镜像源
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/r
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
# 3.可选:宽松优先级,允许更高版本来自后排频道
conda config --set channel_priority flexible
# 4.让终端显示下载来源,方便排错
conda config --set show_channel_urls yes
查看当前配置的镜像源
bash
conda config --show channels
如若想要恢复官方默认镜像,则可以设置:
bash
# 删除所有镜像源
conda config --remove-key channels
# 恢复设置默认镜像源
conda config --add channels defaults
3. 初始化 Shell(重要!)
安装完成后,需手动初始化 Conda 到当前 shell(如 zsh/bash):
bash
conda init "$(basename "${SHELL}")"
然后重启终端,或执行:
bash
source ~/.zshrc # 或 ~/.bashrc
4. 验证安装
bash
conda --version #或 conda -V
若显示版本号(如 conda 24.x.x
),则安装成功。
查看Conda信息
bash
conda info
检查更新当前conda
bash
conda update conda
❗ 注意事项:
路径差异:
Intel Mac: /usr/local/Caskroom/miniconda/base
Apple Silicon (M1/M2): /opt/homebrew/Caskroom/miniconda/base
避免冲突:
- 如果已安装过 Anaconda/Miniconda,建议先卸载旧版本(删除
~/anaconda3
或~/miniconda3
目录)
5. 创建和管理虚拟环境
① 创建环境
指定 Python 版本并创建独立环境(例如名为 myenv
):
bash
conda create -n myenv python=3.12.1
② 激活环境
使用前需激活目标环境:
bash
conda activate myenv
激活之后所有的与python的操作都是在这个虚拟环境中进行的
③ 关闭环境
即可关闭虚拟环境,这里不需要指定具体的虚拟环境名称
bash
conda deactivate
只回退一层到 base 默认层,如果想要退回系统 Python,需要再执行一次上述命令
bash
系统 Python
↑
(base) ← 终端启动时自动压栈
↑
(myenv) ← 你手动 conda activate myenv 再压一层
④ 删除环境
bash
conda env remove -n myenv
⑤ 克隆环境
bash
conda create -n myenv_copy --clone myenv
⚠️ 注意:只复制 conda 安装的包 (conda list
能看到的那部分),克隆时 不会 复制 pip 安装的包;
6. 查询已存在的虚拟环境
这些虚拟环境都存在/opt/homebrew/Caskroom/miniconda/base/envs文件夹下
bash
conda env list #或 conda info -e 或 conda info --envs
bash
/opt/homebrew/Caskroom/miniconda/base
├── envs/
│ ├── myenv/
│ ├── tf-gpu/
│ └── ...
7. 虚拟环境切换
bash
conda activate 目标环境名
8. 安装或删除库
⚠️ 注意:先conda activate myenv 激活环境后再进行安装包,否则会安装到base或其他环境
当激活虚拟环境后,也就是出现(myenv),就说明已经进入虚拟环境中
安装库
✅ 优先用 Conda 源
bash
conda install package
如果想降级某个包,conda install package=旧版本
✅ 如果 Conda 源没有,再用 pip
bash
pip install some-package
混用 Conda 和 pip 时,先 conda → 后 pip,可减少依赖冲突
如果缓存出现问题,可能会导致安装失败。你可以尝试清理缓存后再试
bash
pip cache purge
删除库
用 Conda 卸载
bash
conda remove package
用 pip 卸载
bash
pip uninstall some-package
查看当前环境已装库
bash
conda list # 列出所有包(含 conda + pip)
pip list # 仅 pip 安装的包
🚫 不推荐:直接安装 Anaconda
Anaconda 体积庞大(>500MB),包含大量预装科学包,可通过:
brew install --cask anaconda
但需手动配置 PATH(类似 Miniconda 的初始化步骤)