已经配置好 Node 环境的读者可以直接前往快速开始。

node.js & npm 安装

下载

官方下载地址 https://nodejs.org/zh-cn/download/ ，可以选择适合自己操作系统的版本，建议选择长期支持版下载对应的版本：

安装

双击下载好的安装包，按照以下流程进行操作；

安装完成后，node 与 npm 会被装到 /usr/local/bin/ 下（上图截取自较早的安装包版本，界面与版本号可能与你下载到的不同，以实际安装流程为准）。

到这一步就说明Node.js & NPM已经安装好了！

验证

检查node.js版本信息，

$  node -v
v22.14.0

看到版本号不低于 v22 即说明当前 node.js 工作环境可用。

pnpm 安装

go-admin-ui 使用 pnpm 管理依赖，仓库中提交的是 pnpm-lock.yaml。 用 npm 或 yarn 安装会忽略该锁文件，装到的依赖版本可能与 CI 不一致。

# 方式一：通过 npm 安装
$ npm install -g pnpm

# 方式二：使用 Node 自带的 corepack（无需额外下载）
$ corepack enable

验证：

$  pnpm -v
9.15.1

版本不低于 9 即可。