一、先确认环境

确保已经安装：

• Python 3.9 ~ 3.12（推荐 3.10/3.11）
• 能正常使用 pip 命令

检查方法：

bash

python --version
pip --version

---

二、核心安装命令（必装）

1. 安装 LangChain 主库

bash

pip install langchain

2. 安装 LangChain 社区扩展（90% 功能都在这里）

bash

pip install langchain-community

3. 安装要用的大模型包（任选其一 / 都装）

OpenAI（最常用）

bash

pip install langchain-openai

通义千问（阿里云）

bash

pip install langchain-dashscope

文心一言（百度）

bash

pip install langchain-google-genai

智谱 GLM / 豆包

bash

pip install zhipuai langchain-core

---

三、配置 API 密钥（最关键）

方法 1：临时配置（当前终端有效）

Windows：

bash

set OPENAI_API_KEY=你的密钥

Mac / Linux：

bash

export OPENAI_API_KEY=你的密钥

---

方法 2：永久配置（推荐，一劳永逸）

• 安装 python-dotenv

bash

pip install python-dotenv

• 在项目文件夹里新建文件：.env内容如下：

env

# .env 文件
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
DASHSCOPE_API_KEY=xxxxxxxxxxxx

• 代码里加载（必须写在最前面）

python

from dotenv import load_dotenv
load_dotenv()  # 自动读取 .env 文件

---

四、最简测试代码（验证是否配置成功）

python

from dotenv import load_dotenv
from langchain_openai import ChatOpenAI

# 加载环境变量
load_dotenv()

# 初始化模型
llm = ChatOpenAI(model="gpt-3.5-turbo")

# 测试调用
response = llm.invoke("你好，简单介绍下自己")
print(response.content)

运行不报错 = 环境配置成功 

---

五、可能遇到的错误 + 快速解决

1. No module named 'langchain'→ 重新执行：pip install langchain
2. API key not found→ 检查 .env 文件是否放在正确目录
3. 模型调用超时→ 检查网络 / 更换模型