Node.js未安装或PATH未配置导致“command not found”，需据架构、网络及版本需求选装：软件中心一键安装（新手）、APT源装NodeSource LTS包（Vue/React推荐）、nvm多版本管理（混合项目）、离线解压配PATH（无网环境）。
您正在银河麒麟操作系统上搭建前端或服务端 JavaScript 开发环境，但终端执行 node 命令提示 “command not found”，说明 Node.js 运行时未就位，也未完成路径注册——此时必须根据系统架构（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 不可用，说明安装过程被中断或权限不足，需重试第④步。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
方法二：手动配置仓库（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（适合维护Vue2/Vue3/Electron混合项目）
nvm 允许你在同一台机器上共存多个 Node.js 版本，并按项目切换，比如 Vue 2 项目用 v16，Vue 3 项目用 v20，Electron 旧版要求 v14——没有 nvm，你只能反复卸载重装，极易污染全局模块。
① 在终端中执行安装脚本：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash。
② 关闭当前终端，重新打开一个新终端窗口——这一步不能跳过，否则 shell 无法加载 nvm 函数。
③ 运行 command -v nvm，若返回 nvm 字样，说明环境变量已生效。
④ 列出所有可用的长期支持版本：nvm ls-remote --lts。
⑤ 安装最新 LTS 版本：nvm install --lts。
⑥ 设置默认使用该版本：nvm alias default 'lts/*'。
⑦ 执行 node -v 检查当前激活版本，输出应与第⑤步安装的版本一致。
手动解压二进制包并配置PATH（适用于离线环境或定制化部署）
这一步操作起来很简单，直接把下载好的 node-v20.12.2-linux-x64.tar.xz 文件拖进终端所在目录就行。
解压到 /opt 目录：sudo tar -xvf node-v20.12.2-linux-x64.tar.xz -C /opt。
进入解压后目录确认结构：ls /opt/node-v20.12.2-linux-x64/bin，应能看到 node 和 npm 两个可执行文件。
编辑全局环境配置：sudo vim /etc/profile，在文件末尾追加两行：export NODE_HOME=/opt/node-v20.12.2-linux-x64export PATH=$PATH:$NODE_HOME/bin。
使配置立即生效：source /etc/profile。
验证：node -v 和 npm -v 必须同时返回有效版本号——若只返回 node 版本而 npm 报错，说明 /opt/node-v20.12.2-linux-x64/bin 路径下缺少 npm 文件，需重新下载完整包。
