银河麒麟系统需按架构和网络条件选择Node.js安装方式:软件中心一键安装适合新手;APT源安装推荐Vue/React项目;nvm支持多版本管理;离线环境可用二进制包手动配置PATH。

您正在银河麒麟操作系统上搭建前端或服务端 JavaScript 开发环境,但终端执行 node 命令提示“command not found”,说明系统尚未安装 Node.js 运行时,也未完成 PATH 注册——此时需根据您的 CPU 架构(x86_64 或 aarch64)、网络连通性(在线/离线)、是否需多版本共存等实际条件,选择匹配的安装路径,选错会导致命令不可用、npm 初始化失败甚至项目依赖解析中断。
用麒麟软件中心一键安装(适合新手/无命令行经验)
第一步:点击屏幕左下角“开始菜单”→选择“软件中心”启动应用。
第二步:在顶部搜索框中输入 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 允许你在同一台机器上并存 Vue 2、Vue 3、Electron 旧版等不同项目所需的 Node.js 版本,切换只需一条命令。
第一步:在终端中执行安装脚本:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash。
第二步:关闭当前终端,重新打开一个新终端窗口以加载 nvm 环境变量。
第三步:执行 command -v nvm,若返回 nvm 则表示安装成功。
第四步:列出所有可用的长期支持版本:nvm ls-remote --lts。
第五步:安装最新 LTS 版本:nvm install --lts。
手动解压二进制包并配置PATH(适用于离线环境)
当你无法联网,或需精确控制 Node.js 版本与部署路径时,此法最可靠。
第一步:下载对应架构的 .tar.xz 包(如 aarch64 用户选 node-v20.12.2-linux-arm64.tar.xz,x86_64 用户选 node-v20.12.2-linux-x64.tar.xz)。
第二步:解压到临时目录:tar -xvf node-v20.12.2-linux-x64.tar.xz。
第三步:将解压出的文件夹移动至 /opt/node:sudo mv node-v20.12.2-linux-x64 /opt/node。
第四步:编辑用户级环境变量:vim ~/.bashrc,在文件末尾添加两行:export NODE_HOME=/opt/nodeexport PATH=$PATH:$NODE_HOME/bin
第五步:立即生效配置:source ~/.bashrc。
第六步:验证:node -v 和 npm -v 应分别输出 v20.12.2 和对应 npm 版本。


















