Ubuntu 系统下 Anaconda 完整安装与环境配置指南(附常见问题解决)

发布于:2025-09-13 ⋅ 阅读:(14) ⋅ 点赞:(0)

在数据分析、机器学习或深度学习领域,Anaconda 是必备工具之一 —— 它能一键管理 Python 环境和各类库,避免版本冲突问题。本文以 Ubuntu 系统为例,详细记录 Anaconda 从安装到验证的完整流程,同时针对 “conda 命令找不到” 等常见问题提供解决方案,新手也能轻松上手。

一、安装前准备

1. 确认安装包来源

若已有本地安装包(如本文中存放于 data1/soft 目录的 Anaconda3-2021.05-Linux-x86_64.sh),可直接使用;若无,需从 Anaconda 官网 下载对应 Linux 版本的 .sh 格式安装包(建议选择 Python 3.x 系列,兼容性更强)。

2. 打开终端

通过快捷键 Ctrl + Alt + T 打开 Ubuntu 终端,后续所有操作均在终端中完成。

二、Anaconda 安装步骤

1. 导航到安装包所在目录

假设安装包存放在 ~/data1/soft~ 代表当前用户主目录,即 /home/ubuntu),通过 cd 命令进入该目录:

cd ~/data1/soft

若不确定安装包路径,可通过 ls 命令查看当前目录文件(ls ~/data1/soft),确认 .sh 安装包存在。

2. 赋予安装脚本执行权限

Linux 系统中,.sh 文件默认无执行权限,需通过 chmod 命令赋予:

chmod +x Anaconda3-2021.05-Linux-x86_64.sh

命令中 Anaconda3-2021.05-Linux-x86_64.sh 需替换为你的实际安装包名称(可通过 Tab 键自动补全,避免输错)。

3. 运行安装脚本

执行以下命令启动安装程序:

./Anaconda3-2021.05-Linux-x86_64.sh

此时会进入交互安装界面,按提示逐步操作:

  • 步骤 1:查看许可协议
    终端会滚动显示 Anaconda 许可协议,按 Enter 键逐页查看,或直接按 Q 键跳过协议。
  • 步骤 2:接受协议
    出现 Do you accept the license terms? [yes|no] 时,输入 yes 并按 Enter(输入 no 会终止安装)。
  • 步骤 3:选择安装路径
    默认安装路径为 ~/anaconda3(即 /home/ubuntu/anaconda3),直接按 Enter 确认即可;若需自定义路径,需输入完整路径(如 /opt/anaconda3,但自定义路径需确保权限足够)。
  • 步骤 4:添加环境变量(关键)
    出现 Do you wish the installer to initialize Anaconda3 by running conda init? [yes|no] 时,建议输入 yes—— 这会自动将 Anaconda 路径添加到系统环境变量,后续可直接使用 conda 命令。

等待安装完成(终端会显示 “Thank you for installing Anaconda3!”),此时基础安装已结束。

三、验证安装与环境配置

安装完成后,必须关闭当前终端并重新打开一个新终端(环境变量需重启终端才能生效),然后通过以下步骤验证:

1. 检查 conda 是否可用

在新终端中输入:

conda --version

若输出类似 conda 4.10.3 的版本信息,说明安装成功;若提示 “conda:未找到命令”,需按以下方案解决。

四、常见问题:“conda 命令找不到” 解决方案

若重启终端后仍无法使用 conda 命令,本质是 Anaconda 环境变量未配置成功,可通过以下两种方式修复:

方案 1:手动添加环境变量

  1. 编辑 bash 配置文件(~/.bashrc 是终端启动时自动加载的配置文件):
    nano ~/.bashrc
    
  2. 在文件末尾添加 Anaconda 路径(需与实际安装路径一致,默认路径如下):
    export PATH="/home/ubuntu/anaconda3/bin:$PATH"
    
  3. 保存并退出编辑器:
    按 Ctrl + O(字母 O,不是数字 0),再按 Enter 确认保存;之后按 Ctrl + X 退出 nano 编辑器。
  4. 使配置生效:
    source ~/.bashrc
    

方案 2:重新初始化 conda

若手动添加环境变量无效,可通过 Anaconda 自带的 conda init 命令重新配置:

  1. 执行初始化命令(默认路径示例,需替换为实际安装路径):
    ~/anaconda3/bin/conda init
    
  2. 终端会显示 modified /home/ubuntu/.bashrc,说明已修改配置文件;
  3. 关闭当前终端,重新打开新终端,再次输入 conda --version 验证,此时通常能正常显示版本。