Agent学习一：开发环境搭建

阿荻在肝了2026-04-04 9:27

设计目标 ：为具备 Linux 应用开发经验的学习者搭建专业化、可复现、安全隔离的 Agent 开发环境，避免"在我机器上能跑"的经典陷阱，同时建立工程化协作基础。

复制代码

# 1. 系统更新 & 基础编译依赖（避免后续 pip 安装报错）
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3.10 python3.10-venv python3.10-dev \
                   build-essential libssl-dev libffi-dev \
                   curl wget git zsh tmux htop


# 2. 安装 pyenv（推荐：精准控制 Python 版本）
curl https://pyenv.run | bash

# 将以下内容追加到 ~/.bashrc 或 ~/.zshrc
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
source ~/.bashrc
pyenv install 3.10.12  # LangChain 官方推荐版本
pyenv global 3.10.12


# 3. 验证关键组件
python --version  # 应输出 3.10.12
pip --version
git --version

	原因	避免的坑
pyenv 管理 Python	避免系统 Python 被污染，精准匹配 LangChain 依赖	`sudo pip install` 导致系统包冲突
显式安装 dev 包	确保 `cryptography` 等 C 扩展包编译成功	`pip install` 时因缺失头文件失败
不预装 CUDA	聚焦基础环境，GPU 配置过于复杂	避免被驱动问题劝退