Python多版本管理工具——Anaconda

文章内容

  • 安装Anaconda安装程序
  • Anaconda 设置Python版本
  • 在VScode中使用Python虚拟环境
  • Anaconda 常用命令

安装Anaconda安装程序

  • 访问下载页面:前往Anaconda官网的下载页面( https://www.anaconda.com/download/success )。
  • 启动安装程序:找到下载的.exe文件(例如 Anaconda3-xxx.xx-x-Windows-x86_64.exe),右键点击并选择“以管理员身份运行”。
  • 安装指引
    • 在欢迎界面点击 Next
    • 阅读并同意许可协议,点击 I Agree
    • 选择安装范围:Just Me (recommended) (仅当前用户)或 All Users (所有用户,需要管理员权限)。对于个人用户,通常选择 "Just Me" 即可
    • 选择安装路径: 强烈建议不要将Anaconda安装在系统盘(C盘)默认路径,因为它及其后续安装的包会占用大量磁盘空间。例如我安装在: E:\anaconda3
    • 高级安装选项(Advanced Installation Options)界面,您会看到两个关键选项:
      • Add Anaconda to my PATH environment variable (将Anaconda添加到PATH环境变量): 官方通常不建议勾选此选项 ,因为可能会与系统上已存在的其他Python版本发生冲突。更稳妥的做法是安装完成后手动配置环境变量
      • Register Anaconda as my default Python 3.x (将Anaconda注册为默认Python):建议勾选此选项,这将把Anaconda自带的Python设置为系统默认的Python解释器
  • 配置环境变量
    • 打开环境变量设置:在Windows搜索栏中输入“环境变量”,选择“编辑系统环境变量”
    • 编辑Path变量
    • 在“系统变量”区域,找到并选中名为 ​​Path​​ 的变量。
    • 点击“编辑”按钮。
    • 点击“新建”,然后添加以下路径(请将 您的安装路径 替换为实际的Anaconda安装目录)
      • 您的安装路径(例如:E:\anaconda3)
      • 您的安装路径\Scripts(例如:E:\anaconda3\Scripts)
      • 您的安装路径\Library\bin(例如:E:\anaconda3\Library\bin)
    • 为了确保系统优先使用Anaconda的Python,建议使用 “上移”按钮,将这些新添加的路径移动到列表的顶部
    • 依次点击所有打开的窗口中的“​​确定​​”以保存设置。
    • 验证配置
  • 完全关闭并重新打开一个新的命令提示符窗口,然后输入以下命令进行验证
    • python --version
    • 如果正确显示Python版本(如 Python 3.x.x),则说明问环境变量设置正确。

Anaconda 设置Python版本

通过创建新虚拟环境添加新的python版本(推荐)

  • 打开命令行: 打开"Anaconda Prompt"(Windows)或终端(macOS/Linux)。
  • 创建新环境: 使用 conda create命令创建一个新环境,并指定你需要的Python版本。
    • conda create --name mine_python_3.10 python=3.10
    • --name mine_python_3.10:为你新创建的环境指定一个名称(例如 mine_python_3.10)。
    • python=3.10:指定在该环境中安装的Python版本(例如3.10),你可以将其替换为任何可用的版本,如 3.8, 3.12等
  • 确认安装: 命令行会提示你确认安装,列出将要安装的包。输入 y并按回车继续。
  • 激活新环境: conda activate mine_python_3.10 。 可能需要在新终端(命令提示符)中才能激活。

在VScode中使用Python虚拟环境

  • 准备工作
    • 在VScode中安装Pylance插件 作者Microsoft microsoft.com
    • 在VScode中安装Python插件 作者Microsoft microsoft.com
  • 打开命令面板: Ctrl+Shift+P
  • 选择解释器: Python: Select Interpreter
  • 定位虚拟环境
    • VSCode通常会自动检测到所有已存在的Anaconda虚拟环境
    • 或者定位到你的安装路径 E:\anaconda3\envs\

Anaconda 常用命令归纳

环境管理

环境管理是 Conda 的核心功能,它允许您为不同项目创建相互隔离的 Python 环境。

创建新环境
使用 conda create 命令可以创建一个新的虚拟环境。您可以选择指定 Python 版本,并在创建时安装必要的包。

# 创建一个名为 myenv 的新环境
conda create --name myenv

# 创建环境并指定 Python 版本为 3.10
conda create --name myenv python=3.10

# 创建环境时直接安装多个包(如 numpy 和 pandas)
conda create --name myenv python=3.10 numpy pandas

激活与退出环境
创建环境后,需要激活才能使用。退出环境则返回基础(base)环境。

# 激活名为 myenv 的环境(Windows/Linux/macOS 通用)
conda activate myenv

# 退出当前环境
conda deactivate

激活后,命令行提示符通常会显示当前环境名,如 (myenv)。

查看环境列表
您可以查看所有已创建的虚拟环境列表,当前激活的环境前会有一个星号(*)标记。

conda env list
# 或者使用
conda info --envs

删除环境
当某个环境不再需要时,可以将其彻底删除以释放磁盘空间。

conda remove --name myenv --all

克隆与导出环境
您可以克隆一个已有的环境作为备份,或者将环境配置导出为文件,方便在其他机器上复现相同的环境。

# 克隆环境
conda create --name myenv_copy --clone myenv

# 导出当前环境配置到 environment.yml 文件
conda env export > environment.yml

# 根据 YAML 文件创建新环境
conda env create -f environment.yml

包管理

在激活的特定环境中,您可以方便地管理各种软件包。

安装包
使用 conda install 命令安装包。建议优先使用 Conda 而非 pip,以更好地处理依赖关系。

# 在当前激活的环境中安装 numpy
conda install numpy

# 安装指定版本的包(如 numpy 1.23.0)
conda install numpy=1.23.0

# 一次安装多个包
conda install pandas matplotlib scikit-learn

# 从特定的频道(如 conda-forge)安装包
conda install -c conda-forge opencv

更新与卸载包
您可以更新单个包、所有包,或卸载不再需要的包。

# 更新指定的包(如 numpy)
conda update numpy

# 更新环境中的所有包(请谨慎操作,可能引起依赖冲突)
conda update --all

# 卸载指定的包
conda remove numpy

查看已安装的包
列出当前环境中所有已安装的包及其版本。

conda list

搜索包
在安装前,您可以搜索可用的包版本。

# 模糊搜索包名中包含特定字段的包
conda search pandas

# 精确搜索特定包名的所有版本
conda search --full-name python

配置与实用命令

查看信息与更新 Conda

# 查看 Conda 版本
conda --version

# 更新 Conda 自身到最新版本
conda update conda

清理缓存
定期清理缓存可以释放磁盘空间。

# 清理所有类型的缓存(包括未使用的包和临时文件)
conda clean --all

配置国内镜像源
为了提升在国内的下载速度,可以配置清华镜像等国内源。

# 以配置清华源为例
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/cloud/conda-forge/
conda config --set show_channel_urls yes

如果需要恢复默认源,可以使用命令 conda config --remove-key channels。