银河麒麟系统需按网络、架构和需求选装Node.js:软件中心一键安装适合新手;APT源安装需注意nodejs命名差异并建软链接;NodeSource仓库推荐Vue/React项目;离线环境可手动解压二进制包并配置PATH。

你正在银河麒麟操作系统上搭建前端或服务端 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(2026年7月17日)。
手动解压二进制包并配置 PATH(适用于离线环境)
第一步:确认 CPU 架构,执行 uname -m。
若输出 x86_64,下载地址为:wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-x64.tar.xz
若输出 aarch64,下载地址为:wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-arm64.tar.xz
第二步:解压并重命名:tar -xvf node-v*.tar.xzmv node-v*-linux-* node
第三步:移动到系统级目录:sudo mv node /opt
第四步:配置全局环境变量:
执行 sudo vim /etc/profile,在文件末尾添加:export NODE_HOME=/opt/nodeexport PATH=$PATH:$NODE_HOME/bin
保存后执行 source /etc/profile。
第五步:验证安装:node -v && npm -v 输出版本号即成功。这一步操作起来很简单,直接在终端敲完回车就能看到结果。


















