“command not found”说明Node.js未安装或PATH未配置,需据架构(x86_64/aarch64)、网络(在线/离线)、多版本需求选择安装方式:软件中心一键安装(新手)、APT源装NodeSource LTS(Vue/React推荐)、nvm管理多版本(混合项目)、离线解压配PATH(无网环境)。

您在银河麒麟操作系统上执行 node 命令提示“command not found”,说明 Node.js 运行时未安装,或已安装但未正确注册到 PATH 环境变量中——此时必须先确认 CPU 架构(x86_64 或 aarch64)、网络状态(在线/离线)、是否需多版本共存,再选择对应路径,否则 npm 无法初始化、项目依赖解析会中断,甚至导致 Vue/React 脚手架创建失败。
用软件中心一键安装(新手首选)
第一步:点击屏幕左下角“开始菜单”→选择“软件中心”启动应用。
第二步:在顶部搜索框中输入 Node.js 并按回车键。
第三步:找到名称为“Node.js(JavaScript 运行时)”的条目,确认发布者是“Kylin Software Center”或“麒麟软件有限公司”。
第四步:点击右侧“安装”按钮,输入管理员密码完成安装。
第五步:打开全新终端窗口,执行 node -v && npm -v——若同时输出类似 v20.12.2 和 10.5.0 的字符串,说明安装成功。
通过APT源安装NodeSource官方LTS包(推荐Vue/React项目)
方法一:自动脚本方式(最简路径)
① 打开终端,运行 sudo apt update 更新本地索引。
② 若未预装 curl,先执行 sudo apt install -y curl。
③ 添加 Node.js 20.x LTS 仓库:curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -。
④ 安装运行时:sudo apt install -y nodejs。
⑤ 验证:node --version 应输出 v20.12.2 或更高 LTS 版本;npm --version 必须同步返回有效数字——若 npm 不可用,说明安装过程被中断或权限不足,需重试第④步。
方法二:手动配置仓库(ARM64用户必选)
执行命令添加 GPG 密钥:curl -fsSL https://deb.nodesource.com/gpgkey/nodesource.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg。
根据麒麟OS底层代号写入源(Ubuntu 22.04 对应 jammy):echo "deb [arch=arm64 signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x jammy main" | sudo tee /etc/apt/sources.list.d/nodesource.list。
【注意】x86_64 用户请将命令中的 arm64 替换为 amd64,否则 apt update 会报错并跳过该源。
更新并安装:sudo apt update && sudo apt install -y nodejs。
用nvm管理多版本Node.js(适合混合项目)
第一步:打开终端,执行以下命令下载并安装 nvm:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash。
第二步:关闭当前终端,重新打开一个新终端窗口,使 nvm 加载生效。
第三步:运行 nvm install 22 安装 Node.js 22.x 版本(OpenClaw 等新框架要求),安装完成后自动设为默认版本。
第四步:验证:node -v 输出应为 v22.14.0 或更高,nvm list 显示当前使用的版本带 -> 标记。
第五步:如需切换版本,例如临时使用 20.x,执行 nvm use 20 即可——这一步操作起来很简单,直接输入命令回车就行。
离线环境手动配置二进制包PATH(专用于无网络场景)
第一步:将预下载的 Node.js 二进制包(如 node-v22.14.0-linux-x64.tar.xz)复制到目标机器任意目录,例如 /home/user/Downloads。
第二步:解压并移动到系统级路径:sudo tar -xf node-*.tar.xz -C /opt && sudo mv /opt/node-v* /opt/node。
第三步:编辑系统级环境变量文件:sudo nano /etc/profile,在文件末尾新增两行:export NODE_HOME=/opt/nodeexport PATH=$PATH:$NODE_HOME/bin
第四步:执行 source /etc/profile 使当前终端立即生效。
第五步:新开终端,运行 node -v 和 npm -v 验证输出——若仍提示 command not found,请检查 /opt/node/bin 下是否存在 node 和 npm 可执行文件,缺失则说明解压不完整或包损坏。


















