银河麒麟系统需按场景选择node.js安装方式:软件中心一键安装适合新手;apt源安装需注意nodejs命令名及软链接;nodesource仓库推荐vue/react项目;nvm适合多版本管理;离线安装适用于无网络环境。

您正在银河麒麟操作系统上搭建前端或服务端 JavaScript 开发环境,但终端执行 node 命令提示“command not found”,说明系统尚未安装 Node.js 运行时;此时需根据您的网络状况、CPU 架构(x86_64 或 aarch64)、是否需多版本共存等实际条件,选择匹配的安装路径——不是所有方法都适合当前场景,选错会导致命令不可用、版本不兼容甚至 npm 无法初始化。
用麒麟软件中心一键安装(适合新手/无命令行经验)
第一步:点击屏幕左下角“开始菜单”→选择“软件中心”启动应用。
第二步:在顶部搜索框中输入 Node.js 并按回车键。
第三步:在结果中找到名称为“Node.js(JavaScript 运行时)”的条目,确认发布者是“Kylin Software Center”或“麒麟软件有限公司”。
第四步:点击右侧“安装”按钮,输入管理员密码完成安装。
第五步:打开新终端,执行 node -v && npm -v ——若同时输出类似 v18.20.4 和 9.9.0 的字符串,说明安装成功。
通过 APT 源安装基础版(适合快速部署且不挑版本)
方法一:直接安装系统仓库版
打开终端,依次执行:sudo apt updatesudo apt install -y nodejs npm
注意:此方式安装的可执行文件名为 nodejs 而非 node,直接运行 node -v 会报错。
补救操作:执行 sudo ln -sf /usr/bin/nodejs /usr/bin/node 创建软链接,再验证 node -v。
方法二:使用 NodeSource 官方 LTS 仓库(推荐用于 Vue/React 项目)
① 执行命令添加 GPG 密钥:curl -fsSL https://deb.nodesource.com/gpgkey/nodesource.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg
② 根据麒麟 OS 底层代号写入源(Ubuntu 20.04 对应 focal,22.04 对应 jammy):echo "deb [arch=amd64 signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x focal main" | sudo tee /etc/apt/sources.list.d/nodesource.list
ARM64 用户请将 amd64 替换为 arm64。
③ 更新并安装:sudo apt update && sudo apt install -y nodejs
④ 验证:node -v 应输出 v20.12.2 或更高 LTS 版本。
用 nvm 管理多个 Node.js 版本(适合维护 Vue2/Vue3/Electron 混合项目)
第一步:执行安装脚本:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
第二步:关闭当前终端,重新打开一个新终端窗口——这一步不能跳过,否则 nvm 命令不可用。
第三步:运行 command -v nvm,返回 nvm 表示加载成功。
第四步:配置国内镜像加速(避免下载超时):export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node,并追加到 ~/.bashrc 中。
第五步:安装最新 LTS 版本:nvm install --lts,完成后自动激活。
第六步:设为默认版本:nvm alias default 'lts/*'。
离线手动解压二进制包(适用于物理隔离/无外网环境)
第一步:在有网络的机器上访问 https://www.php.cn/link/0c9097d0139751fc728f1614cca51b43,下载对应架构的 .tar.xz 包(x86_64 选 linux-x64,ARM64 选 linux-arm64)。
第二步:将压缩包拷贝至麒麟系统(如 ~/Downloads/node-v20.12.2-linux-x64.tar.xz),执行:sudo mkdir -p /opt/nodejs && sudo tar -xf ~/Downloads/node-v20.12.2-linux-x64.tar.xz -C /opt/nodejs --strip-components=1。
第三步:将 bin 目录加入 PATH:echo 'export PATH="/opt/nodejs/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。
第四步:验证:node --version 输出版本号即完成。











