麒麟os需手动安装node.js，推荐nodesource仓库装lts版；软件中心图形化安装适合新手，apt方式需手动创建node软链接，二进制包适用于离线或定制化部署。
在麒麟OS上搭建前端开发或服务端运行环境，必须先安装Node.js——它不是预装组件，且不同安装方式直接影响后续npm命令调用、版本切换和项目构建的稳定性。系统未预设全局node命令，直接执行node -v会报错，必须完成环境变量配置或软链接修复才能正常使用。
用软件中心图形化安装（新手首选）
适合首次接触麒麟OS、不熟悉命令行、需快速验证环境是否可用的用户。该方式由麒麟官方打包并签名，自动注册环境变量，无需手动干预路径。
1. 点击屏幕左下角“开始菜单”→选择“软件中心”启动应用。
2. 在顶部搜索框输入Node.js并回车，等待搜索完成。
3. 找到发布者为“Kylin Software Center”或“麒麟软件有限公司”的条目，名称为“Node.js (JavaScript 运行时)”，确认图标为橙色JS标识。
4. 点击右侧“安装”按钮，输入管理员密码（即开机登录密码）完成安装。
5. 安装完毕后，打开新终端窗口，执行node -v和npm -v，显示版本号即成功。
通过APT源安装基础版（快速但需手动修复）
该方式利用麒麟OS底层Debian兼容性，安装速度快，但默认二进制名为nodejs，不提供node命令，不修复将导致所有脚手架工具（如vue-cli、create-react-app）无法识别运行时。
1. 打开终端，执行sudo apt update更新包索引。
2. 执行sudo apt install -y nodejs npm完成安装。
3. 验证：运行nodejs --version，确认输出类似v18.19.1。
4. 【关键修复】执行sudo ln -sf /usr/bin/nodejs /usr/bin/node创建标准命令软链接。
5. 再次运行node -v，若仍报错，请检查是否遗漏第4步——这是APT方式最常被跳过的致命步骤。
用NodeSource仓库装LTS版（推荐生产使用）
适用于需要匹配Vue 3、React 18、Electron等现代框架最低版本要求的场景。NodeSource提供长期支持（LTS）版本，如v20.x或v22.x，比APT源版本更新及时、兼容性更强。
方法一：一键脚本安装（推荐）
1. 在终端中执行：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
2. 执行：sudo apt install -y nodejs
3. 验证：node -v应显示v20.17.0或v22.14.0等LTS版本号。
方法二：手动添加源（ARM64用户必选）
1. 先确认架构：uname -m，若输出aarch64，则需替换源中的架构标识。
2. 添加GPG密钥：curl -fsSL https://deb.nodesource.com/gpgkey/nodesource.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/nodesource.gpg
3. 添加源（以ARM64 + Ubuntu 22.04兼容源为例）：echo "deb [arch=arm64 signed-by=/usr/share/keyrings/nodesource.gpg] https://deb.nodesource.com/node_22.x jammy main" | sudo tee /etc/apt/sources.list.d/nodesource.list
4. 更新并安装：sudo apt update && sudo apt install -y nodejs
手动解压配置二进制包（离线/定制化部署）
适用于无外网环境、需指定精确版本（如v24.15.0）、或要统一部署到/opt等标准路径的运维场景。此方式完全可控，但每一步路径和权限都必须准确，否则node命令永远找不到。
第一步：下载与解压
1. 访问https://nodejs.org/en/download/，根据uname -m结果选择对应包：x86_64选linux-x64.tar.xz，aarch64选linux-arm64.tar.xz。
2. 下载完成后，在文件所在目录右键→“打开终端”，执行：tar -xf node-v24.15.0-linux-x64.tar.xz。
第二步：移动与配置
3. 执行：sudo mv node-v24.15.0-linux-x64 /usr/local/node（不建议放/opt，因部分麒麟桌面版对该目录有额外安全策略限制）。
4. 编辑用户级环境文件：echo 'export PATH=/usr/local/node/bin:$PATH' >> ~/.bashrc。
5. 生效配置：source ~/.bashrc。
6. 验证：node -v输出v24.15.0即完成。
