开始前准备

Node.js 和 npm
到底是什么

看懂安装 Agent 时最常出现的两个名字,并学会检查本机环境。

预计阅读 9 分钟公开免费核验于 2026.08.19
内容目录 当前:第 02
开始前准备6
Agent 基础5
工具安装与配置6
模型与接口5
进阶专题5
本文目录 3 个部分

大家好,我是云途。很多工具的安装说明第一行就写着 Node.js、npm 或 npx。新手最容易在这里停下来,因为不知道它们分别负责什么。

这篇只讲安装工具时真正会用到的部分,不展开成 JavaScript 编程课。

把它们看成运行环境、包管理器和临时入口

Node.js 负责运行,npm 管理项目依赖,npx 临时执行包里的命令。你的命令npm / npxnpm管理项目依赖npx执行包命令Node.js实际运行
Node.js 负责运行,npm 管理项目依赖,npx 临时执行包里的命令。
Node.js

让 JavaScript 可以在浏览器外运行的环境。很多 Agent 工具和网页项目依靠它启动。

npm

Node.js 常用的包管理器,负责下载项目需要的依赖,并执行 package.json 里登记的脚本。

npx

用来执行 npm 包提供的命令。适合按官方说明临时启动工具,但仍要确认包名和来源。

先检查,不要重复安装

检查本机版本SHELL
node --version
npm --version
npx --version
能分别看到版本号,说明三个命令已经可以使用。

如果出现 command not found,不要立刻复制来路不明的修复命令。先回到 Node.js 官方下载页,选择当前长期支持版本,并在安装后重新打开终端。

依赖应该放在项目里

当目录里有 package.json 时,npm install 会根据清单把依赖安装到当前项目的 node_modules。这个目录通常可以重新生成,不应该当作项目源码到处复制。

在项目目录安装并运行SHELL
cd /你的项目目录
npm install
npm run dev
实际脚本名以 package.json 的 scripts 为准。
先确认自己位于哪个目录,再运行安装命令。目录错了,依赖就会装错地方。
完成检查

你已经看懂最基础的安装环境

  • 能解释 Node.js、npm 和 npx 的区别。
  • 能用版本命令检查本机环境。
  • 知道项目依赖应安装在当前项目目录。

官方依据与延伸阅读

Node.js introductionnpm package manager