安装 Conda 并配置 LLM 开发环境
Conda 是一个开源的包管理和环境管理系统,主要用于 Python 编程语言,但也能支持 R、Ruby、Lua、Scala、Java 等其他语言。它能够轻松地创建、保存、加载和切换不同的开发环境,每个环境都可以拥有独立版本的软件包及其依赖关系,从而有效解决不同项目之间的包版本冲突问题。通过 Conda,开发者可以快速安装、运行和更新软件包,大大简化了软件部署和项目管理的复杂度。
本文介绍如何安装 Conda 并搭建大语言模型开发环境。
1、环境要求
在开始之前,请确保您的系统满足以下要求:
- ✅ Linux 操作系统(Ubuntu/CentOS 等)
- ✅ 至少 10GB 可用磁盘空间
- ✅ 稳定的网络连接
- ✅ 基本的命令行操作知识
2、检查是否已安装 Conda
首先检查您的系统是否已经安装了 Conda:
conda --version
如果显示版本号(如 conda 24.1.2),说明 Conda 已安装,可以跳过安装步骤。
如果显示 “command not found”,请继续下面的安装步骤。
3、安装 Miniconda
Miniconda 是 Anaconda 的轻量版,只包含 Conda 和 Python,推荐使用。
下载 Miniconda
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
# 如果 wget 不可用,使用 curl:
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
安装 Miniconda
chmod +x Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh
安装提示:
- 按
Enter阅读许可协议 - 输入
yes同意协议 - 按
Enter确认安装路径(默认:~/miniconda3) - 输入
yes初始化 Conda
激活 Conda
source ~/.bashrc
# 或者重新启动终端
4、验证安装
验证 Conda 是否安装成功:
conda --version
conda info
conda env list
如果显示 Conda 版本和环境列表,说明安装成功!
5、配置 Conda(可选但推荐)
设置国内镜像(加速下载)
# 配置清华镜像(国内用户推荐)
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
禁用自动激活 base 环境
conda config --set auto_activate false
6、创建 LLM 开发环境
现在创建专门用于大语言模型开发的环境:
创建环境
conda create -n llm_env python=3.10 -y
激活环境
conda activate llm_env
提示: 激活环境后,命令行提示符会显示环境名称
(llm_env)
7、安装依赖包
安装大语言模型开发所需的包:
安装 PyTorch
# 带 CUDA 支持(推荐)
conda install pytorch==2.6.0 torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia -y# 或 CPU 版本
conda install pytorch==2.6.0 torchvision torchaudio cpuonly -c pytorch -y
安装其他核心包
conda install transformers==4.46.3 tokenizers==0.20.3 -c conda-forge -y
conda install einops addict easydict -c conda-forge -y
安装 Flash Attention(性能优化)
conda install packaging ninja -c conda-forge -y
pip install flash-attn==2.7.3 --no-build-isolation
8、验证环境
创建验证脚本检查所有包是否安装成功:
cat > verify_env.py << 'EOF'
#!/usr/bin/env python3
import importlibdef check_package(package_name, version=None):try:module = importlib.import_module(package_name)if version:actual_version = getattr(module, '__version__', '未知')status = "✅" if str(actual_version).startswith(version) else "⚠️"print(f"{status} {package_name}=={actual_version}")else:print(f"✅ {package_name} 已安装")return Trueexcept ImportError:print(f"❌ {package_name} 未安装")return Falseprint("=== 环境验证 ===")
check_package("torch", "2.6")
check_package("transformers", "4.46")
check_package("tokenizers", "0.20")
check_package("einops")
check_package("addict")
check_package("easydict")try:import flash_attnprint("✅ flash_attn 已安装")
except ImportError:print("❌ flash_attn 未安装")print("=== 验证完成 ===")
EOFpython verify_env.py
9、完整的一键安装脚本
创建一键安装脚本,简化整个过程:
cat > install_llm_env.sh << 'EOF'
#!/bin/bashecho "=== 开始安装 Miniconda 和 LLM 环境 ==="# 检查是否已安装 Conda
if command -v conda &> /dev/null; thenecho "✅ Conda 已安装,跳过安装步骤"
elseecho "📥 下载 Miniconda..."wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda.shecho "🔧 安装 Miniconda..."bash miniconda.sh -b -p $HOME/miniconda3echo "🔄 初始化 Conda..."$HOME/miniconda3/bin/conda init bashsource ~/.bashrcrm miniconda.shecho "✅ Miniconda 安装完成"
fi# 配置镜像
echo "🌐 配置 Conda 镜像..."
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# 创建环境
echo "🐍 创建 LLM 环境..."
conda create -n llm_env python=3.10 -y# 激活环境
conda activate llm_env# 安装依赖
echo "📦 安装 PyTorch..."
conda install pytorch==2.6.0 torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia -yecho "📦 安装其他包..."
conda install transformers==4.46.3 tokenizers==0.20.3 -c conda-forge -y
conda install einops addict easydict packaging ninja -c conda-forge -yecho "⚡ 安装 Flash Attention..."
pip install flash-attn==2.7.3 --no-build-isolationecho "✅ 全部安装完成!"
echo "使用命令激活环境:conda activate llm_env"
EOFchmod +x install_llm_env.sh
./install_llm_env.sh
10、日常使用命令
环境配置完成后,常用的 Conda 命令:
# 激活环境
conda activate llm_env# 退出环境
conda deactivate# 安装新包
conda install package_name# 导出环境配置
conda env export > environment.yml# 从文件创建环境
conda env create -f environment.yml
11、常见问题解决
问题1:Conda 命令找不到
# 手动添加到 PATH
export PATH="$HOME/miniconda3/bin:$PATH"
# 永久添加
echo 'export PATH="$HOME/miniconda3/bin:$PATH"' >> ~/.bashrc
问题2:Flash Attention 安装失败
# 安装编译工具
conda install cmake make -c conda-forge -y
# 重新尝试
pip install flash-attn --no-build-isolation --upgrade
问题3:网络连接问题
# 使用国内镜像下载
wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/Miniconda3-latest-Linux-x86_64.sh
问题4:接受 Anaconda 的条款服务
(base) root@SHANHY-THINKBOOK:~# conda create -n deepseek-ocr python=3.12.9 -yCondaToSNonInteractiveError: Terms of Service have not been accepted for the following channels. Please accept or remove them before proceeding:- https://repo.anaconda.com/pkgs/main- https://repo.anaconda.com/pkgs/rTo accept these channels' Terms of Service, run the following commands:conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/mainconda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/rFor information on safely removing channels from your conda configuration,
please see the official documentation:https://www.anaconda.com/docs/tools/working-with-conda/channels
解决方案(先接受条款再重试创建):
# 接受主要通道的条款
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
(END)
