LangChain 国内怎么装：npm、pnpm、yarn 访问与验证

LangChain 是用于开发大模型应用的框架，可帮助普通用户安装依赖并连接模型、工具与数据源。

截至 2026 年 11 月，LangChain.js 官方目录列出的受支持 Node.js 版本为 20.x、22.x 和 24.x。先按官方支持范围准备环境，比安装失败后再追查 Node.js、锁文件和代理配置更省时间。下文的版本与命令均来自官方仓库。

先分清：下载框架和访问模型是两件事

LangChain 本身通过 npm、pnpm 或 yarn 安装；安装后，程序仍然要连接具体的大模型服务。因此，“LangChain 能不能下载”和“模型接口能不能访问”必须分开排查。

如果 npm 下载失败，问题通常位于运行环境、包源或网络链路，尚未进入 LangChain 代码。如果框架已经安装，但调用模型时超时或无法连接服务，继续重装 langchain 通常不能解决模型端点、密钥或网络访问问题。LangChain 官方仓库只负责提供框架与集成代码，没有承诺某个固定地址在所有国内网络环境下都始终可达。

可先打开以下三个官方入口：

• LangChain.js 主仓库：https://github.com/langchain-ai/langchainjs
• langchain 包目录：https://github.com/langchain-ai/langchainjs/tree/main/libs/langchain/
• LangChain 官方文档：https://docs.langchain.com/langchain/

官方仓库主页会显示代码、目录、文档入口和社区讨论区；包目录还包含 package.json、CHANGELOG.md、许可证与 TypeScript 配置。读者可以直接访问这些页面，核对安装说明和当前目录内容。

三种安装方式，按现有项目选择

三条命令均来自 LangChain.js 官方 README。选包管理器只看一件事：项目已经配好了哪个 —— 已有 package-lock.json 就用 npm，已有 pnpm-lock.yaml 就用 pnpm，已有 yarn.lock 就用 Yarn。这样能避免生成多套锁文件，也减少团队成员装出不同依赖树的风险。不要在一个项目里依次执行三种安装方式；仓库顶层带 pnpm-lock.yaml 只说明官方仓库自身用 pnpm，推不出所有第三方项目都该用它。

按项目完成安装与检查

1. 进入项目根目录，打开 VS Code 后选择菜单栏的“文件 → 打开文件夹”，选中包含 package.json 的项目文件夹。然后按项目已有的包管理器执行对应命令——三选一，不要混用（否则会生成多套锁文件）：

# npm（项目里有 package-lock.json 时）
npm install -S langchain

# pnpm（项目里有 pnpm-lock.yaml 时）
pnpm install langchain

# Yarn（项目里有 yarn.lock 时）
yarn add langchain

2. 在 VS Code 左侧“资源管理器”中依次展开项目根目录、node_modules 和 langchain，确认能看到 package.json。同时打开项目根目录的 package.json，在 dependencies 中查找 langchain。

3. 打开仓库里的变更记录，核对安装后采用的版本：https://github.com/langchain-ai/langchainjs/tree/main/libs/langchain/。目录中的 CHANGELOG.md 是官方发布的版本变化记录；如果程序行为与教程不一致，应先看对应版本的变化，再调整调用代码。

4. 打开项目根目录的 package.json，确认 engines 与本机 Node.js 版本相符。官方包目录当前列出的受支持环境是 Node.js 20.x、22.x、24.x，还包括 Cloudflare Workers、Vercel、Next.js、Supabase Edge Functions、浏览器、Deno 和 Bun。普通用户首次安装优先使用受支持的 Node.js LTS 版本，不需要为了运行 LangChain 一次部署到所有边缘平台。

国内网络下的卡点，按层处理

包管理器连不上包仓库

先确认执行目录是项目根目录：VS Code 中应打开项目文件夹，而不是单独打开某个脚本文件。然后只使用项目原有包管理器重试对应命令。若终端长时间停留在下载阶段，先检查终端是否仍配置了失效代理、VPN 或公司网络策略，再决定是否恢复；不同网络环境对官方包仓库的连通性并不相同，不能把一次超时写成 LangChain 自身的固定限制。

如果浏览器能打开 GitHub，但包安装仍失败，两者也不矛盾：浏览器访问 GitHub 与 npm、pnpm、yarn 下载依赖属于不同网络路径。可用 https://registry.npmjs.org/langchain 检查 npm 官方包页面能否打开；若该地址打不开，先解决包仓库访问，不要先修改 LangChain 示例代码。

安装成功，程序却提示找不到模块

检查是否在正确的项目目录运行程序。VS Code 里的判断路径是：打开“视图 → 终端”，终端顶部应显示项目根目录；随后展开资源管理器中的 node_modules/langchain，应能找到 package.json。若项目使用 pnpm，依赖可能采用符号链接结构，但仍应能在项目依赖目录中找到对应包。

出现找不到模块时，不要反复重装整个项目。先确认程序从哪个目录启动、导入名称是否为 langchain，再检查 package.json 中是否已经出现该依赖。另一个常见误区是只在交互式 Node.js 会话里安装，却忘了把依赖写入项目清单；因此应优先使用上节给出的三条保存依赖命令，而不是临时安装命令。

模型调用失败，但框架导入正常

框架安装成功只说明代码依赖已就绪，不表示模型服务已经连通。把故障拆成三项：模型服务地址能否访问、API 密钥是否有效、应用发出的请求是否被代理或服务端拒绝。排查时保留完整终端输出，依据服务状态码和错误原文继续定位；不要把模型接口超时归因于 langchain 安装失败。

怎么算安装成功

完成后应同时观察到三个结果：

• VS Code 资源管理器中的 node_modules/langchain 目录存在；
• 项目根目录 package.json 的 dependencies 中出现 langchain；
• 应用代码能够从 langchain 导入所需组件，不再出现“找不到模块”或依赖解析错误。

模型是否可用要单独验证：成功连接模型服务并收到有效响应，才算整条调用链完成。不要把“包已安装”和“模型已可用”混为一谈，这正是国内网络排障中最容易浪费时间的地方。

继续排查与更新

官方仓库的 Issues 和 Discussions 可用于搜索相同报错：https://github.com/langchain-ai/langchainjs。提交问题前，应包含 Node.js 版本、所用包管理器、完整错误文本、最小复现代码以及脱敏后的网络环境；不要公开 API 密钥。

包目录中的 README.md 给出安装命令和支持环境，CHANGELOG.md 用于核对版本变化，官方文档入口则是 https://docs.langchain.com/langchain/。若 Python 项目，可从主仓库 README 进入官方 Python 仓库；JS 项目则应继续沿 langchainjs 路径操作，不要混装两套包和两套示例。

参考来源

• LangChain.js 官方 README：本文三种安装命令与 Node.js 支持版本的出处
• langchainjs 官方仓库：monorepo 结构、libs/langchain 包目录
• langchainjs Releases：版本与变更记录（对应正文”查 CHANGELOG 再决定升级”）
• LangChain 官方文档：安装后的概念与 API 入口