系列目标：从零开始，每天一篇，30 天带你从 LangChain 入门到企业级项目部署！
今日任务：理解 LangChain 是什么 + 搭建开发环境 + 跑通你的第一个 LLM 调用！
🔍 一、为什么需要 LangChain？
你可能已经用过 OpenAI 的 API 直接调用大模型：
response = openai.ChatCompletion.create(
model="gpt-3.5-turbo",
messages=[{"role": "user", "content": "你好！"}]
)
但当你要构建一个真正的 AI 应用（比如智能客服、知识库问答、自动写报告）时，你会发现：
- 需要管理对话历史（Memory）
- 要把用户问题和提示词模板拼接（Prompt Engineering）
- 要连接数据库或文档（RAG）
- 要让 AI 调用工具（搜索、计算器、API）
- 要处理错误、流式输出、日志监控……
LangChain 就是为解决这些问题而生的框架！它提供了一套标准化的组件（Chains、Agents、Tools、Memory 等），让你像搭积木一样快速构建复杂 AI 应用。
✅ 官网：www.langchain.com
✅ GitHub：github.com/langchain-a…
🛠️ 二、环境搭建（5 分钟搞定）
1. 安装 Python（建议 3.9+）
确保你已安装 Python。推荐使用 pyenv 或直接下载 Python 官方安装包。
2. 创建虚拟环境（可选但推荐）
python -m venv langchain-env
source langchain-env/bin/activate # Linux/Mac
# langchain-env\Scripts\activate # Windows
3. 安装 LangChain 核心库
pip install langchain
💡 我们后续会按需安装其他依赖（如
langchain-openai,chromadb等），避免一次性装太多。
4. 获取 API Key（以 OpenAI 为例）
- 访问 OpenAI 平台
- 创建账号 → 进入 API Keys 页面 → 创建新 Secret Key
- 不要泄露你的 Key！
将 Key 设置为环境变量（推荐）：
# Linux / Mac
export OPENAI_API_KEY='你的密钥'
# Windows (PowerShell)
$env:OPENAI_API_KEY="你的密钥"
🌐 国内替代方案：如果你无法访问 OpenAI，也可以使用 Ollama + 本地模型（如 qwen:7b、llama3），Day 2 会教你怎么切换！
🚀 三、跑通你的第一个 LangChain 程序！
我们来用 LangChain 调用一次 GPT，比原生 API 更简洁！
✅ 示例代码：用 ChatOpenAI 发送消息
# day1_hello_langchain.py
from langchain_openai import ChatOpenAI
# 初始化 LLM（默认使用 gpt-3.5-turbo）
llm = ChatOpenAI()
# 调用模型
response = llm.invoke("你好！请用一句话介绍你自己。")
print(response.content)
▶️ 运行结果（示例）：
我是由 OpenAI 开发的语言模型，能够回答问题、创作文字、编程等。
⚠️ 注意：
langchain-openai是 LangChain 0.1+ 版本后拆分出的独立包，需单独安装：pip install langchain-openai
🔧 四、常见问题 & 解决方案
| 问题 | 原因 | 解决方法 |
|---|---|---|
ModuleNotFoundError: No module named 'langchain_openai' | 未安装 langchain-openai | pip install langchain-openai |
AuthenticationError | API Key 错误或未设置 | 检查 OPENAI_API_KEY 环境变量 |
| 网络超时 | 国内访问 OpenAI 不稳定 | 使用代理，或改用 Ollama（Day 2 教你） |
报错 langchain 无 ChatOpenAI | 使用了旧版 LangChain | 升级：pip install --upgrade langchain langchain-openai |
📝 五、今日小结
- ✅ LangChain 是构建 AI 应用的“脚手架”
- ✅ 安装了
langchain和langchain-openai - ✅ 用 3 行代码调用了 GPT 模型
- ✅ 学会了设置 API Key 和处理常见错误
