00. 环境配置

从零开始，一步一步完成本课程所需的所有环境配置。

1. 安装 Miniconda

Conda 是一个包管理和环境管理工具。Miniconda 是 Conda 的精简版，只包含最基本的组件，体积小、安装快，推荐使用。

1.1 下载 Miniconda

打开 Miniconda 官方下载页面： https://docs.anaconda.com/miniconda/

根据操作系统选择对应版本：

操作系统	推荐安装包
Windows	Miniconda3 Windows 64-bit（.exe 安装包）
macOS	Miniconda3 macOS Apple M1 64-bit（Apple 芯片）或 macOS Intel x86 64-bit（Intel 芯片）
Linux	Miniconda3 Linux 64-bit（.sh 脚本）

注意：Miniconda 自带 Python 3.13，本课程也使用 Python 3.13，无需额外调整。

1.2 Windows 安装步骤

1. 双击下载的 Miniconda3-windows-*.exe，启动安装向导
2. 点击 Next → 选择 Just Me (recommended) → Next
3. 安装路径建议保持默认（如 C:\Users\你的用户名\miniconda3），点击 Next
4. 关键步骤：勾选以下两项：
   • ✅ Add Miniconda3 to my PATH environment variable（将 Conda 加入系统 PATH）
   • ✅ Register Miniconda3 as my default Python 3.x（设为默认 Python）
5. 点击 Install，等待安装完成
6. 安装完成后，打开 Anaconda Prompt (miniconda3)（从开始菜单搜索）

验证安装是否成功：

conda --version
# 输出类似：conda 26.x.x

1.3 macOS 安装步骤

# 在终端中执行（以 Apple M1 芯片为例）
bash ~/Downloads/Miniconda3-latest-MacOSX-arm64.sh

# 按提示操作：
#  - 按 Enter 阅读协议
#  - 输入 yes 接受协议
#  - 确认安装路径（默认 ~/miniconda3 即可）
#  - 输入 yes 执行 conda init

安装完成后，关闭并重新打开终端，验证：

conda --version

1.4 Linux 安装步骤

# 在终端中执行
bash ~/Downloads/Miniconda3-latest-Linux-x86_64.sh

# 按提示操作，步骤同 macOS

2. Conda 基础操作

命令	作用
conda --version	查看 Conda 版本
conda info --envs	列出所有虚拟环境
conda create -n 环境名 python=3.10	创建新环境
conda activate 环境名	激活（进入）某个环境
conda deactivate	退出当前环境
conda remove -n 环境名 --all	删除某个环境
conda list	列出当前环境已安装的包

核心概念：虚拟环境就是一个隔离的 Python 运行空间，不同环境之间互不影响。比如你可以同时拥有一个用 Python 3.13 的 langgraph 环境和一个用 Python 3.12 的 other_project 环境。

3. 创建课程环境

3.1 创建并激活环境

# 创建名为 langgraph 的环境，指定 Python 3.13
conda create -n langgraph python=3.13

# 出现 Proceed ([y]/n)? 时输入 y 回车确认
# 等待下载和安装完成（约 1-2 分钟）

# 激活环境
conda activate langgraph

激活成功后，终端提示符前面会出现 (langgraph)，表示当前已进入该环境：

(langgraph) C:\Users\你的用户名>

验证 Python 版本：

python --version
# 输出：Python 3.13.x

3.2 配置 pip 镜像源（中国大陆用户建议）

由于课程依赖包较多，配置国内镜像可以大幅提升下载速度：

# 设置清华大学 pip 镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

验证配置：

pip config list
# 应看到：global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'

如果后续遇到镜像源不稳定，可随时恢复默认：

pip config unset global.index-url