安装与环境

建议使用 Python 3.10 及以上版本，并为项目单独创建虚拟环境。

使用 venv

python3 -m venv .venv
source .venv/bin/activate
pip install -U pip

安装 LangChain

pip install -U langchain

根据模型供应商安装对应集成包。例如 OpenAI：

pip install -U langchain-openai

如果使用 LangGraph：

pip install -U langgraph

环境变量

建议把 API Key 放到 .env，不要写死到代码里：

OPENAI_API_KEY=你的key
LANGSMITH_TRACING=true
LANGSMITH_API_KEY=你的langsmith_key

Python 中可以使用：

pip install python-dotenv

from dotenv import load_dotenv
load_dotenv()

常见问题

1. ImportError 找不到 create_agent

这通常是版本不一致或安装包过旧。先确认：

pip show langchain
pip list | grep langchain

然后升级：

pip install -U langchain langchain-openai langgraph

2. 公司网络无法访问模型 API

优先确认代理、DNS、服务器出口、防火墙和 API 平台的地区限制。生产环境不要依赖本地代理，应使用稳定的云服务器出口或合规的模型服务。

非官方声明

本站为个人维护的非官方中文学习文档，不代表 LangChain 官方。页面内容是基于公开文档、源码实践和中文开发者视角重新整理的学习资料。涉及 API 细节时，请以官方文档和实际安装版本为准。

参考来源

• LangChain / LangGraph 官方文档：https://docs.langchain.com/
• LangChain API Reference：https://reference.langchain.com/
• 本站内容为中文学习整理，不做官方身份声明。