环境搭建

从零开始搭建 LangGraphJS 开发环境，包含详细的安装步骤和配置指南

📚 学习目标

学完这篇文章后，你将能够：

配置 Node.js 开发环境
创建并初始化一个 LangGraph 项目
安装核心依赖并理解其作用
运行验证脚本确保环境正常

前置知识

在开始学习之前，建议先阅读：

你需要了解：

基本的命令行操作
npm/pnpm 包管理器的基本使用

1️⃣ 系统要求

Node.js: 版本 18.0.0 或更高（推荐最新 LTS 版本）
包管理器: 推荐 pnpm（更快、更省空间），也可以使用 npm 或 yarn
编辑器: VS Code（推荐安装 TypeScript 插件）

[!TIP] 检查版本命令：node -v 和 npm -v

2️⃣ 快速开始

创建新项目

# 1. 创建目录
mkdir my-langgraph-project
cd my-langgraph-project

# 2. 初始化
pnpm init

# 3. 安装核心依赖
pnpm add @langchain/langgraph @langchain/core @langchain/openai zod dotenv

# 4. 安装开发依赖
pnpm add -D typescript @types/node esno

依赖说明

包名	作用
`@langchain/langgraph`	核心图框架
`@langchain/core`	基础抽象（Messages, Tools 等）
`@langchain/openai`	OpenAI 模型集成
`zod`	Schema 定义和校验
`dotenv`	环境变量加载
`esno`	直接运行 TS 文件（基于 esbuild，超快）

3️⃣ 环境配置

API 密钥设置

创建 .env 文件：

# .env
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
# 如果使用 LangSmith 调试
LANGCHAIN_TRACING_V2=true
LANGCHAIN_API_KEY=lsv2-xxxxxxxxxxxxxx

[!WARNING] 请务必将 .env 添加到 .gitignore 文件中，防止密钥泄露！

TypeScript 配置

创建 tsconfig.json：

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "skipLibCheck": true,
    "allowSyntheticDefaultImports": true
  },
  "include": ["src/**/*"]
}

4️⃣ 验证安装

创建 src/index.ts：

import 'dotenv/config';
import { StateGraph, Annotation, START, END } from '@langchain/langgraph';
import { HumanMessage } from '@langchain/core/messages';
import { ChatOpenAI } from '@langchain/openai';

// 1. 定义状态
const StateAnnotation = Annotation.Root({
  message: Annotation<string>,
});

// 2. 创建节点
const llmNode = async (state: typeof StateAnnotation.State) => {
  const model = new ChatOpenAI({ model: 'gpt-3.5-turbo' });
  const response = await model.invoke([new HumanMessage(state.message)]);
  return { message: response.content };
};

// 3. 构建图
const graph = new StateGraph(StateAnnotation)
  .addNode('llm', llmNode)
  .addEdge(START, 'llm')
  .addEdge('llm', END)
  .compile();

// 4. 运行
const result = await graph.invoke({ message: '你好！LangGraph' });
console.log('AI回复:', result.message);

运行测试：

pnpm esno src/index.ts

如果看到 AI 的回复，恭喜你，环境搭建成功！🎉

💡 练习题

操作题：尝试将示例代码中的模型改为 gpt-4o（如果你有权限），或者尝试更换 prompt。
排错题：如果运行报错 OpenAI API key not found，你应该检查哪些地方？（提示：.env 文件位置、dotenv 加载、API Key 是否有余额）

📚 参考资源

官方文档

LangGraph JS

✅ 总结

本章要点：

成功的环境搭建是开发的第一步。
掌握 .env 管理密钥是安全开发的基础。
StateGraph 的最小化示例验证了核心依赖的可用性。

下一步：环境就绪，让我们进入更深入的组件学习——《核心组件详解》。

登录以继续阅读

解锁完整文档、代码示例及更多高级功能。

立即登录

环境搭建

登录以继续阅读

On this page