安装并验证

安装LangChain、langchain-core和langchain-text-splitters。

python3 -m pip install langchain langchain-core langchain-text-splitters

安装完成后记录实际安装版本。

python3 -m pip show langchain langchain-core langchain-text-splitters

验证LangChain是否安装成功。

创建验证脚本validate_langchain_basic.py。

import langchain
import langchain_core
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.runnables import RunnableLambda
from langchain_text_splitters import RecursiveCharacterTextSplitter

def validate_imports():
    print("langchain=" + langchain.__version__)
    print("langchain_core=" + langchain_core.__version__)

def validate_runnable():
    runnable = RunnableLambda(lambda value: value + 1)
    result = runnable.invoke(1)
    assert result == 2
    print("runnable_result=" + str(result))

def validate_prompt():
    prompt = ChatPromptTemplate.from_template("Hello, {name}!")
    messages = prompt.format_messages(name="ARM")
    assert len(messages) == 1
    assert "ARM" in messages[0].content
    print("prompt_result=" + messages[0].content)

def validate_text_splitter():
    splitter = RecursiveCharacterTextSplitter(chunk_size=20, chunk_overlap=5)
    chunks = splitter.split_text("LangChain runs successfully on ARM platform.")
    assert len(chunks) > 0
    print("chunk_count=" + str(len(chunks)))

if __name__ == "__main__":
    validate_imports()
    validate_runnable()
    validate_prompt()
    validate_text_splitter()
    print("LangChain basic validation passed")

执行验证。
1
python3 validate_langchain_basic.py

预期输出。

langchain=
langchain_core=
runnable_result=2
prompt_result=Hello, ARM!
chunk_count=
LangChain basic validation passed

验收标准

满足以下条件即可认为基础兼容性验证通过：

表1 验收标准
验收项	通过标准
安装验证	LangChain、langchain-core、langchain-text-splitters均可通过pip安装。
导入验证	import langchain、import langchain_core均无异常。
Runnable验证	RunnableLambda可以正常执行并返回预期结果。
Prompt验证	ChatPromptTemplate可以正常格式化消息。
Text splitter验证	RecursiveCharacterTextSplitter可以正常切分文本。

常见问题

如果安装失败，优先检查Python版本是否满足依赖要求。

python3 --version
python3 -m pip index versions langchain
python3 -m pip index versions langchain-core

如果提示构建wheel失败，记录完整错误日志，并重点关注以下信息。

表2 信息说明
信息	说明
Python版本不满足	需要更换符合依赖要求的Python版本。
缺少编译工具	可能需要安装GCC、python3-devel等构建依赖。
无ARM wheel	依赖包可能没有提供当前平台wheel，需要源码构建。

本次基础验证不应主动引入向量数据库、文档解析、Embedding、外部模型调用等依赖。如果这些依赖报错，应单独拆成扩展验证问题处理。

父主题： 安装指南