1. 为什么使用 Conda?
在 Python 开发中,不同项目经常需要不同版本的 Python 和依赖库。例如:
- 项目 A:Python 3.12 + Django + requests
- 项目 B:Python 3.12 + LangChain + OpenAI SDK + PyTorch
- 项目 C:Python 3.9 + 旧版依赖
如果全部安装到系统 Python,会出现版本冲突。Conda 通过创建独立环境解决:
MacBook │ └── Miniconda │ ├── base │ ├── py312 │ Python 3.12 │ LangChain │ └── pytorch AI环境每个环境互不影响。
2. Conda 与 pip 的区别
2.1 pip 是什么?
pip 是 Python 官方包管理工具。主要负责:
- 安装 Python 第三方库
- 管理 Python package
例如:安装 LangChain:
pip install langchain==1.2.12安装其他库:
pip install numpy pip install pandas pip install requests2.2 conda 是什么?
conda 是环境和软件包管理工具。主要负责:
- 创建 Python 环境
- 管理 Python 版本
- 安装软件依赖
- 管理底层库(C/C++等)
例如:创建 Python 3.12 环境:
conda create -n py312 python=3.12进入环境:
conda activate py312退出:
conda deactivate2.3 conda 和 pip 配合关系
实际开发中通常:
conda | |-- 创建环境 | | | └── Python 版本 | └── pip | └── 安装 Python 库推荐流程:
conda create -n langchain python=3.12 conda activate langchain pip install langchain==1.2.12即:
- conda 管环境
- pip 管 Python 库
3. MacBook M4 安装 Miniconda
3.1 确认 CPU 架构
Mac M4:Apple Silicon (ARM64)
必须下载:Miniconda3-latest-MacOSX-arm64.sh
不要下载:MacOSX-x86_64(否则使用 Rosetta 转译,性能下降)。
4. 下载 Miniconda
推荐清华镜像:
Index of /anaconda/miniconda/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror
下载:Miniconda3-latest-MacOSX-arm64.sh
进入下载目录:
cd ~/Downloads运行安装:
bash Miniconda3-latest-MacOSX-arm64.sh5. Miniconda 安装步骤
5.1 接受协议
看到:Do you accept the license terms?
输入:yes
5.2 设置安装目录
默认:/Users/用户名/miniconda3
推荐直接按Enter使用默认路径。
不要输入:yes(否则会误安装到~/Downloads/yes)。
5.3 初始化 Conda
出现:Proceed with initialization? [yes|no]
输入:yes
安装程序会修改~/.zshrc。
6. 激活 Conda
重新打开终端,或者执行:
source ~/.zshrc成功后提示符变为:
(base) wangaoyun@Mac ~ %7. 检查 Conda
查看版本:
conda --version示例输出:conda 26.5.3
查看环境:
conda env list查看平台:
conda info确认:platform : osx-arm64(说明 M4 ARM 环境正常)。
8. 配置国内镜像
提高下载速度:
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge conda config --set show_channel_urls yes检查配置:
conda config --show channels9. 创建 LangChain 开发环境
不要直接使用 base 环境。
创建环境:
conda create -n langchain python=3.12进入环境:
conda activate langchain确认 Python 版本:
python --version输出:Python 3.12.x
10. 安装 LangChain
在 langchain 环境中执行:
pip install langchain==1.2.12检查安装:
pip show langchain查看输出:
Name: langchain Version: 1.2.1211. LangChain 常用依赖
根据项目需要安装:
- OpenAI 模型:
pip install langchain-openai - 环境变量管理:
pip install python-dotenv - Jupyter:
pip install jupyter - 常用工具:
pip install requests numpy pandas
12. 推荐项目结构
AI_Project │ ├── .env ├── main.py ├── requirements.txt │ └── Conda Environment | └── langchain Python 3.12 LangChain 1.2.1213. 日常使用流程
打开终端:
conda activate langchain开发:
python main.py安装新库:
pip install 包名退出环境:
conda deactivate14. 常用命令速查
- 创建环境:
conda create -n 环境名 python=版本 - 查看环境:
conda env list - 进入环境:
conda activate 环境名 - 删除环境:
conda remove -n 环境名 --all - 查看 Python:
python --version - 查看 pip 包:
pip list - 安装 Python 包:
pip install 包名
15. 最终环境结构
MacBook M4 │ └── Miniconda │ ├── base │ └── langchain Python 3.12 LangChain 1.2.12 AI开发环境推荐日常开发:
conda activate langchain然后开始 LangChain / AI 应用开发。