必须安装node.js运行时:一、apt官方源装lts版(适合快速启动vue项目);二、nodesource装v20.x/v24.x(满足vite 5.4/next.js 14.2最低v18.17+要求);三、nvm管理多版本(适配angular 12等跨项目需求);四、手动解压二进制包(用于离线或arm64/loongarch64环境)。

您在统信UOS系统中需要立即运行npm install或启动vite dev,但终端提示“command not found: node”,说明Node.js运行时完全缺失,必须从零构建可用的前端执行环境。系统默认不预装Node.js,且官方源版本常滞后于Vite 5.4或Next.js 14.2所需的最低v18.17+要求,不能直接apt install完事。
用APT官方源快速启用LTS基础环境
打开终端,执行更新命令以同步软件包列表:sudo apt update
安装Node.js运行时及配套npm工具:sudo apt install -y nodejs npm
验证安装结果:node --version && npm --version。若输出类似v18.19.1和9.2.0,则可跳过后续方法;若版本低于v16.0.0(如v12.x),请立即停止并切换到NodeSource方法——旧版本无法解析现代ES模块语法,create-vue会卡死在依赖图生成阶段。
用NodeSource仓库安装v20.x或v24.x指定版本
方法一:安装v20.x长期支持版
下载并执行setup脚本:curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
执行安装命令:sudo apt install -y nodejs
验证版本:node -v。输出应为v20.18.0或更高。
方法二:安装v24.x当前活跃版
替换setup脚本地址:curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
同样执行:sudo apt install -y nodejs
注意:v24.x需配套npm v10.7+,若npm -v返回低于10.7,请立即运行sudo npm install -g npm@latest——否则pnpm create vite@latest会因peer dependency校验失败而中断。
使用nvm管理多版本Node.js
第一步:下载并执行nvm安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
第二步:重新加载shell配置(以bash为例)
source ~/.bashrc
第三步:列出所有远程LTS版本
nvm ls-remote --lts
第四步:安装最新LTS版本
nvm install --lts
第五步:设置默认使用的版本
nvm alias default lts/*
这一步确保新开终端自动加载该版本,避免每次手动nvm use;若跳过此步,新终端仍将沿用系统级node(如果存在)或报command not found。
第六步:验证当前激活版本
node -v











