1. 从零开始:为什么选择LangChain搭建LLM应用?
凌晨1点23分,我的终端再次弹出那个熟悉的报错——ConnectionError: Failed to connect to http://localhost:11434。这已经是今晚第六次遇到这个问题,手边的咖啡早已凉透。作为一名有十年开发经验的工程师,我不得不承认:直接调用大语言模型(LLM)的原生API,远比想象中复杂得多。
这就是LangChain存在的意义。它不是另一个需要你从头学习的庞大框架,而是一个能让你少写重复胶水代码的工具集。想象一下,当你需要:
- 管理对话历史
- 处理不同类型的消息格式
- 切换不同模型提供商
- 解析各种响应结构
传统做法中,这些都需要你手动编写大量重复代码。而LangChain将这些通用模式抽象成了标准接口,让你能专注于业务逻辑本身。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备:避坑指南与必备工具
2.1 硬件与软件基础配置
在开始之前,请确保你的系统满足以下要求:
- 操作系统:macOS/Linux/Windows(本文以macOS Sonoma为例)
- Python版本:3.9+(推荐3.11.8)
- 内存:至少8GB(运行phi3:mini需要约2GB空闲内存)
- 磁盘空间:至少5GB可用空间
重要提示:Windows用户请以管理员身份运行终端,且项目路径不要包含中文或空格(推荐使用
C:\langchain-demo)
2.2 关键组件安装顺序
正确的安装顺序能避免90%的常见问题:
- 首先安装Ollama(模型运行环境)
- 然后创建Python虚拟环境
- 最后安装LangChain相关包
bash复制# 1. 安装Ollama(详见官网)
brew install ollama # macOS
# 或下载对应系统的安装包
# 2. 创建虚拟环境
python -m venv langchain-env
source langchain-env/bin/activate # macOS/Linux
# Windows: langchain-env\Scripts\activate.bat
# 3. 安装Python依赖
pip install --upgrade pip
pip instal
