跳到主要内容

Linux安装Conda教程


Linux安装Conda教程

1. 准备工作

使用普通用户安装和管理个人 Conda 环境。先确认 CPU 架构与发行版,老系统还应核对所选安装器的 glibc 等系统要求:

uname -m
cat /etc/os-release

以 Ubuntu/Debian 为例,缺少下载工具时执行:

sudo apt update
sudo apt install curl ca-certificates

Fedora/RHEL 系统应改用其包管理器和对应包名,不要混用两套命令。

2. 下载 Miniconda 安装脚本

选择与 uname -m 一致的安装器。下面只处理 x86_64 和 aarch64;其他架构先查看官方支持范围:

case "$(uname -m)" in
    x86_64) INSTALLER_ARCH=x86_64 ;;
    aarch64) INSTALLER_ARCH=aarch64 ;;
    *) echo "请先查阅官方安装器的架构支持范围" >&2; exit 1 ;;
esac

INSTALLER="Miniconda3-latest-Linux-${INSTALLER_ARCH}.sh"
curl -fL -o "$INSTALLER" "https://repo.anaconda.com/miniconda/$INSTALLER"

上述命令会把安装器写到当前目录;已有同名下载时先另存或核对,不要覆盖正在保留的历史版本。生产或需要复现的环境,应选择并记录具体安装器版本,而不是一直使用 latest。

3. 验证安装包完整性

sha256sum "$INSTALLER"

将结果与 官方安装器目录 中该文件的 SHA256 比较。确认文件名、架构与校验值对应,再执行安装;只算出一个哈希但不比较,不能证明下载正确。

4. 安装 Miniconda

bash "$INSTALLER"

使用 Bash 执行不需要先修改安装器的执行权限。阅读许可协议,选择安装目录;下面以默认的 $HOME/miniconda3 为例,已有同名安装时不要直接安装覆盖。

安装器如询问是否初始化当前 shell,可按自己的使用方式选择;安装路径不同时,下文的路径也要相应修改。

5. 初始化与激活

当前 Bash 会话

source "$HOME/miniconda3/etc/profile.d/conda.sh"
conda activate base

以后打开 Bash 时也能激活环境

"$HOME/miniconda3/bin/conda" init bash

执行后重新打开终端,再运行 conda activate。conda init 会管理 shell 配置中的初始化片段,不要反复手动粘贴整段自动生成代码。使用 Zsh 等其他 shell 时,应按该 shell 的初始化方式处理,不直接加载 Bash 配置。

只把 miniconda3/bin 加入 PATH,通常只能让系统找到 conda 可执行文件,不能替代支持 conda activate 的 shell 初始化。如果修改过安装目录,先确认实际路径:

test -f "$HOME/miniconda3/etc/profile.d/conda.sh"

6. 验证安装

conda --version
conda info --envs
python -c "import sys; print(sys.executable)"

确认当前环境的 Python 路径位于预期 Conda 安装或环境目录。不要把教程中的旧版本号当作唯一成功标准。

7. 基本使用

创建独立项目环境,以 Python 3.11 为例:

conda create -n myenv python=3.11
conda activate myenv
conda install numpy

有些 channel 可能要求先确认服务条款,应按实际提示处理。需要 pip 时,确认它属于当前环境:

python -m pip --version

先用 Conda 安装所需依赖,再按项目需要补充 pip 包,避免在同一环境中反复用两种工具替换同一组包。

更新 base 环境中的 conda:

conda update -n base conda

8. 常见问题排查

conda 命令未找到或不能 activate

先检查实际安装目录和正在使用的 shell。Bash 中可重新加载对应的 conda.sh,再尝试激活;无需重装整个系统或改全局 Python 链接。

安装器不能执行

核对 CPU 架构、下载是否完整及系统库要求。较旧发行版不一定能运行当前 latest 安装器,应以所选版本的官方要求为准。

包下载失败

检查网络、代理、channel 配置和具体报错。使用镜像时核对其支持的仓库;不要通过关闭 SSL 校验来掩盖证书问题。

9. 参考资料


文章作者: 0xdadream
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 0xdadream !
赏
评论

评论将在接近此处时加载,也可点击立即加载。

  目录