在虚拟环境（venv）中安装 LangChain 是最佳实践，可以避免不同项目之间的依赖冲突。

第一步：准备 Python 环境

LangChain 目前对 Python 版本有严格要求。

版本要求：必须是 Python 3.10、3.11 或 3.12。

注意：Python 3.9 及以下版本已不再受支持，如果版本过低请先升级。

第二步：创建并激活虚拟环境

我们需要为 LangChain 项目创建一个独立的“隔离空间”。请在命令行（Windows 下推荐用 PowerShell 或 CMD）中依次执行：

1、创建项目文件夹并进入

mkdir LangChainProject
cd LangChainProject

2、创建虚拟环境

这里我们将环境命名为 .venv（这是通用的命名习惯）：

python -m venv .venv

3、激活虚拟环境

成功标志：激活后，你的命令行提示符前面会出现 (.venv) 字样。

Windows (CMD):

.venv\Scripts\activate.bat

Windows (PowerShell):

.venv\Scripts\Activate.ps1

Mac / Linux:

source .venv/bin/activate

第三步：升级 pip 并安装 LangChain

在虚拟环境中，旧版本的 pip 可能会导致找不到包。

1、升级 pip

python -m pip install --upgrade pip

2、安装核心库

安装 LangChain 核心包和 OpenAI 集成包：

pip install langchain langchain-openai

(如果在国内下载速度慢，可以在命令末尾加上 -i https://pypi.tuna.tsinghua.edu.cn/simple 使用清华源加速)。

第四步：验证安装

安装完成后，我们可以通过 Python 检查一下是否成功：

python -c "import langchain; print(f'LangChain 版本: {langchain.__version__}')"

如果输出了版本号，说明安装成功！

---

专家提示：关于依赖包的说明

为了避免环境臃肿和冲突，建议按需安装，不要试图一次性安装所有东西：

langchain: 核心框架，包含通用的链和工具。

langchain-openai: 如果你使用 OpenAI 或兼容 OpenAI 格式的本地模型（如 Ollama, vLLM），必须安装这个包。

langchain-community: 包含社区维护的第三方集成（如各类文档加载器）。除非你明确需要用到某些特定的第三方工具，否则不建议一开始就安装，因为它体积大且依赖复杂。

chromadb: 如果你要做本地知识库（RAG），通常需要安装这个向量数据库。