Node.js 与 pnpm 安装
校对日期:2026-11-16。只有从源码构建时才需要;使用官网的安装包或 Docker 镜像部署不需要 Node.js。
后台管理界面(ujcms-ui-console)和默认主题的静态资源用 Node.js 构建。需要 Node.js 22.12 或以上,包管理器用 pnpm (主题的构建脚本用 Node.js 自带的 npm)。
一、安装 Node.js
在 Node.js 官网下载 22 或更高的 LTS 版本。建议下载压缩包(Windows 为 .zip)而不是安装程序, 同一台机器上可以放多个版本,升级和切换都方便。以下以 Windows、解压到 D:\nodejs 为例:
把压缩包解压到
D:\nodejs,得到D:\nodejs\node-v22.(里面有x. x-win-x64 node.exe、npm.cmd)。 在D:\nodejs下再建两个文件夹npm-global和npm-cache,分别存放全局安装的工具和下载缓存。新建环境变量
NODEJS_HOME,值为上面的解压目录;在Path中加入%NODEJS_HOME%和D:\nodejs\npm-global。 设置环境变量的方法与 JDK 相同,见 JDK 选择与安装。
重新打开一个命令行窗口,执行
node -v,能看到版本号即安装成功。
Linux 和 macOS 同样下载压缩包解压,把其中的 bin 目录加入 PATH 即可。
二、设置 npm
bash
# 全局工具和缓存放到上面建好的目录(Windows 示例)
npm config set prefix "D:\nodejs\npm-global"
npm config set cache "D:\nodejs\npm-cache"
# 国内网络使用镜像源
npm config set registry https://registry.npmmirror.com/每一项都可以用 npm config get <名称> 确认是否设置成功。
三、安装 pnpm
bash
npm install -g pnpm
pnpm -v国内网络同样给 pnpm 设置镜像源:
bash
pnpm config set registry https://registry.npmmirror.com/四、构建命令
在源码根目录执行。两步的产物都不在版本库里,首次运行或打包之前必须先构建:
bash
# 后台管理界面,输出到 ujcms-starter/src/main/webapp/cp
pnpm --dir ujcms-ui-console install
pnpm --dir ujcms-ui-console build:starter
# 默认主题用到的第三方前端库,输出到主题的 assets/vendor
npm --prefix ujcms-starter/src/main/webapp/themes/1/default ci
npm --prefix ujcms-starter/src/main/webapp/themes/1/default run build:vendor五、常见问题
pnpm : 无法加载文件 …\pnpm.。 PowerShell 的执行策略限制。以管理员身份打开 PowerShell, 执行ps1,因为在此系统上禁止运行脚本 Set-ExecutionPolicy RemoteSigned并选择A。'pnpm' 不是内部或外部命令。Path里没有全局工具目录(D:\nodejs\npm-global),或者改完环境变量后没有重新打开命令行窗口。- 构建后台管理界面时内存溢出。 新建环境变量
NODE_OPTIONS,值为--max-old-space-size=。8192