大模型应用开发 / 知识点

LangChain 开发速查手册

手册条目

CODE
安装 LangChain

创建 Python 环境并安装 LangChain 1.x 核心依赖。

安装 LangChain

用于新建隔离的 Python 环境并安装 LangChain 1.x 核心包。LangChain 1.x 要求 Python 3.10 及以上;模型服务商集成包需要另行安装。:contentReference[oaicite:0]{index=0}

命令定位

先确认解释器版本,再创建 .venv。使用 python -m pip 可确保依赖安装到当前解释器,而不是系统中的另一套 pip。

bash
python --version
python -m venv .venv
source .venv/bin/activate

# 先升级安装工具,再安装当前 LangChain 1.x
python -m pip install --quiet -U pip
python -m pip install --quiet -U "langchain>=1,<2"

python -c "import langchain; print(langchain.__version__)"

预期输出

text
Python 3.<MINOR>.<PATCH>
<VERSION>

<MINOR>、<PATCH> 和 <VERSION> 取决于本机及安装时间。最后一行能打印 1.x 版本号,说明虚拟环境和核心包均可用。

Windows 激活

Windows PowerShell 创建环境的命令相同,激活脚本路径不同。

powershell
py -3.10 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --quiet -U pip
python -m pip install --quiet -U "langchain>=1,<2"
python -c "import langchain; print(langchain.__version__)"

预期输出

text
<VERSION>

若 PowerShell 阻止脚本执行,可仅对当前进程放开限制:Set-ExecutionPolicy -Scope Process Bypass,关闭终端后设置自动失效。

常用参数

  • -m venv .venv:在项目目录创建独立环境,避免污染系统 Python。
  • -U:升级到约束范围内的最新版本;生产环境不要无约束升级。
  • "langchain>=1,<2":允许获得 1.x 修复版本,同时阻止未来自动跨到 2.x。
  • deactivate:退出当前虚拟环境。

风险与边界

直接对系统 Python 执行 pip install -U,可能覆盖其他项目依赖并引发版本冲突。安全替代方案是每个项目单独使用 .venv,并在验证后固定依赖:

bash
python -m pip freeze > requirements.txt
python -m pip check

预期输出

text
No broken requirements found.

requirements.txt 会记录当前完整版本;提交前检查其中是否混入仅用于本机调试的包。

排障清单

  • python --version 低于 3.10:安装较新 Python,并用对应解释器重新创建 .venv。
  • 激活后仍安装到全局:执行 python -c "import sys; print(sys.executable)",路径应位于 .venv。
  • 出现依赖冲突:执行 python -m pip check;优先新建干净环境,不要反复强制覆盖。
  • 下载超时:先确认代理、DNS 和 PyPI 连通性,再重试;不要把不受信任的镜像设为永久源。

速查:看到终端提示符含 .venv,且版本验证输出 1.x,即可继续安装模型集成包。

目录与阅读设置

记录一个想法

LangChain 开发速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通