LangChain环境安装Python 环境配置 LangChain 官方目前要求 Python ≥ 3.9，但实际体验

Python 环境配置

LangChain 官方目前要求 Python ≥ 3.9，但实际体验最好的是 3.10 ~ 3.12（兼容性、速度、社区支持最佳平衡点）。推荐版本排序（2026年1月）：

Python 版本	推荐指数	说明
3.12.x	★★★★★	最推荐（速度快、内存省）
3.11.x	★★★★☆	非常稳定，很多老项目还在用
3.10.x	★★★★	目前生态最兼容
3.9.x	★★☆	勉强能用，但很多新功能依赖更高版本
3.13.x	★☆	太新，很多依赖还没适配（慎用）

LangChain分模块安装

LangChain 现在已经不是一个包，而是一套生态碎片化组件。

基础安装（最小可用）

pip install langchain

但说实话，这一步只够你写 demo。

安装模型适配包（按需）

OpenAI（最常用）

pip install langchain-openai openai

Anthropic（Claude）

pip install langchain-anthropic anthropic

本地 / HuggingFace（可选）

pip install langchain-huggingface transformers accelerate

还有其他

LangChain 已拆分为：

langchain-core
langchain-openai
langchain-anthropic

依赖包

LangChain 项目通常会走向三条路之一：

纯 LLM 调用（对话 / Agent）

pip install tiktoken pydantic python-dotenv

tiktoken：token 计算
pydantic：结构化输出（非常重要）
python-dotenv：管理密钥

RAG（检索增强生成）

pip install \
  faiss-cpu \
  sentence-transformers \
  unstructured

如果你用的是向量数据库：

Milvus / Qdrant / Chroma 👉 按需安装，不要全装

Agent + 工具链

pip install \
  httpx \
  aiohttp \
  rich

httpx：现代 HTTP 客户端
rich：调试时，日志会像星空一样清晰

API配置

这是很多人一开始就走歪的地方。

使用 `.env` 文件

项目根目录新建：

OPENAI_API_KEY=sk-xxxx
ANTHROPIC_API_KEY=sk-ant-xxxx

然后加载：

from dotenv import load_dotenv
load_dotenv()

好处只有一个，但致命重要：

你的代码可以被提交、被分享、被部署，而密钥不暴露。

OpenAI / Anthropic 的 LangChain 接入方式

OpenAI（以 GPT-4 / GPT-4o 为例）

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="gpt-4o-mini",
    temperature=0.7
)

llm.invoke("写一句关于星辰与代码的句子")

Anthropic（Claude 系列）

from langchain_anthropic import ChatAnthropic

llm = ChatAnthropic(
    model="claude-3-sonnet-20240229",
    temperature=0.7
)

llm.invoke("用诗意解释什么是 LangChain")

检查

from langchain_openai import ChatOpenAI

llm = ChatOpenAI()
print(llm.invoke("Hello, LangChain"))

如果你看到返回的内容，而不是报错——说明这成功安装了

更多精彩内容请关注微信公众号 “学GIS的小宝同学”

LangChain环境安装