本文面向JavaScript、TypeScript开发者，提供一套可直接部署、可直接运行的LangChain.js v1.x学习教程与实战代码。教程基于最新稳定版规范，适配国内模型平台，解决传统教程版本过时、无法运行、依赖境外服务等问题，帮助前端与Node.js开发者快速掌握LLM应用开发能力。

教程与项目介绍

本项目是LangChain.js v1.x系统化学习教程，包含完整文档与可直接运行的源码，面向国内开发者优化，默认使用魔搭社区API，无需境外账号即可运行全部案例。项目采用教程与代码分离结构，文档用于学习理解，源码用于直接运行验证，降低入门门槛，提升学习效率。

适用版本：LangChain.js v1.x
运行环境：Node.js 20及以上
技术栈：JavaScript、LangChain.js、Zod、国内大模型API
项目特点：版本最新、国内可用、全案例可运行、零基础友好、持续维护

项目优势

1. 版本最新，避免兼容问题
   项目基于LangChain.js v1.x构建，与官方最新API保持一致，解决旧版教程无法运行、参数失效、示例报错等问题，学习内容可直接用于生产环境。

2. 国内可用，无需境外服务
   默认接入阿里云魔搭社区API，支持通义千问、MiniMax、ChatGLM、Yi等主流国内模型，提供免费额度，注册即用，不需要OpenAI账号。

3. 教程与代码配套，全部可运行
   项目同时提供在线文档与对应源码，每个章节知识点均有独立可运行文件，复制配置即可运行，降低动手成本。

4. 结构清晰，循序渐进学习
   教程分为基础篇、进阶篇、高级篇，从环境搭建到RAG、Agent实战，形成完整学习路径，适合零基础自学与系统提升。

5. 常见问题全覆盖
   项目整理环境、密钥、网络、依赖、版本等高频问题与解决方案，减少学习阻碍。

项目结构说明

项目分为文档与源码两部分，结构清晰，便于学习与运行。

langchainjs-learn/
├── tutorial/           教程文档
├── src/               可运行示例代码
│   ├── config.js       模型配置
│   ├── minimax-stream.js 流式输出示例
│   ├── agent.js        智能体示例
│   ├── rag.js          RAG示例
│   ├── memory.js       对话记忆示例
│   ├── tool.js         工具调用示例
│   └── zod.js          输出解析示例
├── .env.example        环境变量模板
├── package.json        依赖配置
└── README.md           使用说明

快速开始步骤

1. 环境准备
   安装Node.js 20及以上版本，执行以下命令检查版本：

node -v

2. 克隆项目
   国内推荐使用Gitee仓库下载，速度更稳定：

git clone https://gitee.com/qiaoyuning/langchainjs-learn.git
cd langchainjs-learn

3. 安装依赖

npm install

4. 配置API密钥
   复制环境变量模板：

cp .env.example .env

编辑.env文件，填入魔搭社区API Key。

5. 运行示例
   运行流式输出示例：

node src/minimax-stream.js

运行RAG示例：

node src/rag.js

运行智能体示例：

node src/agent.js

学习路径

基础篇
01 基础概念
02 环境搭建
03 模型调用
04 消息类型
05 流式输出

进阶篇
06 Prompt模板
07 输出解析器
08 链
09 记忆
10 工具
11 Zod使用说明

高级篇
12 Agent智能体
13 RAG检索增强生成
14 VectorStore向量存储

支持的国内模型

项目支持魔搭社区内可调用的主流模型，可在config.js中自由切换：
MiniMax-M2.5
Qwen2.5-72B-Instruct
chatglm3-6b
Yi-34B-Chat

常见问题与解决方案

API Key无效：检查密钥格式与账户额度
模型不存在：确认模型名称正确、平台支持
网络超时：使用国内网络，增加超时配置
Node.js版本过低：升级至v20及以上
模块未找到：重新执行npm install安装依赖

项目地址

在线文档地址：
https://langchainjs-learn.vercel.app/

GitHub教程仓库：
https://github.com/Qyn77/langchainjs-learn

Gitee完整项目仓库（含可运行源码）：
https://gitee.com/qiaoyuning/langchainjs-learn.git

总结

本项目为国内JavaScript开发者提供最新、可直接运行、零门槛的LangChain.js v1.x学习方案，从基础到实战全覆盖，配套文档与源码，支持国内主流模型，适合快速上手LLM应用开发。项目持续更新，欢迎开发者使用、收藏并提交反馈，共同完善这套LangChain.js中文学习资源。