Node.js在统信UOS中缺失时，需按场景选择安装方式：一、APT官方源快速装LTS版（适合基础Vue项目）；二、NodeSource装v20.x/v24.x（满足Vite 5/Next.js 14最低要求）；三、nvm管理多版本（适配Angular 12/Next.js 14/Deno桥接等多项目）；四、手动解压二进制包（用于离线、未激活或ARM64/LoongArch64环境）。
您在统信UOS系统中需要立即启动Vue或React项目，但终端输入node命令提示“command not found”，说明Node.js运行时完全缺失，必须从零构建前端开发环境基础。系统默认不预装Node.js，且官方源版本常滞后于Vite 5.x或Next.js 14所需的最低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方法——旧版本无法运行现代构建工具，强行继续会卡在create-vue的依赖解析阶段。
用NodeSource仓库安装v20.x或v24.x指定版本
当您要开发Vite 5项目、使用ES2023语法、或需原生支持WebAssembly模块时，必须用此方法。官方源的v18.x虽属LTS，但v20.x起才默认启用--experimental-permission标志，v24.x则内置对Linux ARM64的完整优化。
方法一：安装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——否则create-react-app会因peer dependency冲突失败。
用nvm管理多版本并按项目切换
您同时维护三个项目：一个老Angular 12（需v16.20）、一个新Next.js 14（需v20.18）、一个实验性Deno桥接项目（需v24.11）。nvm是唯一不污染系统、不需sudo、且切换毫秒级的方案。
第一步：下载并执行nvm安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
第二步：手动配置加载路径
该脚本默认将nvm安装到$HOME/.nvm，但部分UOS社区版（如23.0）会因shell配置差异导致~/.bashrc未自动加载nvm路径。此时需手动编辑配置文件：vim ~/.bashrc，在末尾新增三行：
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
保存后执行source ~/.bashrc立即生效；若提示command not found: nvm，说明配置未加载成功，需检查引号是否为英文、路径是否存在空格或中文字符。
第三步：安装并切换至目标版本
执行nvm install --lts，nvm会自动识别当前最新LTS代号（截至2026年5月为Iron，对应v20.18.0），下载并解压至~/.nvm/versions/node/子目录。
若项目明确要求v24.x（如使用WebAssembly GC或Node-API v9），运行nvm install 24.11.1。
【生产环境请优先选择--lts】
第四步：设为默认并验证共存
nvm alias default lts/Iron→
nvm install 18.20.4→
nvm use 18.20.4→node -v输出v18.20.4
nvm use --lts→node -v立刻变为v20.18.0
手动解压二进制包安装（离线/ARM64/未激活专用）
这一步适合没有外网、CPU是龙芯或鲲鹏、或者系统尚未激活无法更换源的场景。所有操作都在用户空间完成，不触碰系统APT机制。
下载对应架构的官方tar.xz包，例如：wget https://nodejs.org/dist/v24.11.1/node-v24.11.1-linux-x64.tar.xz
解压到用户目录：tar -xJf node-v24.11.1-linux-x64.tar.xz -C ~/
创建软链接便于调用：ln -sf ~/node-v24.11.1-linux-x64/bin/node ~/bin/node && ln -sf ~/node-v24.11.1-linux-x64/bin/npm ~/bin/npm
确保~/bin已加入PATH：检查echo $PATH是否含~/bin，若无则在~/.bashrc末尾添加export PATH="$HOME/bin:$PATH"，再执行source ~/.bashrc
验证：node -v && npm -v
