node.js未正确安装或环境变量未生效会导致node -v/npm -v报“command not found”。解决方法包括：一、包管理器安装（apt/dnf/yum）；二、nodesource仓库安装lts版；三、nvm管理多版本；四、手动解压配软链或环境变量；五、自定义npm全局路径。
如果您在Linux系统中执行node -v或npm -v命令时提示“command not found”，则很可能是Node.js未正确安装，或安装后环境变量未生效。以下是多种可靠、可复现的Linux环境下安装Node.js及配置npm环境变量的方法：
一、使用包管理器安装（适用于Ubuntu/Debian与CentOS/RHEL）
该方法依赖系统官方仓库或扩展源，操作快捷，适合快速部署基础开发环境，但版本受发行版更新节奏限制。
1、Ubuntu或Debian系统：运行sudo apt update && sudo apt install nodejs npm，安装完成后系统自动配置/usr/bin/node和/usr/bin/npm路径。
2、CentOS 8+或RHEL 8+：执行sudo dnf module install nodejs，该命令启用模块流并安装默认LTS版本。
3、CentOS 7或RHEL 7：先启用EPEL源sudo yum install epel-release，再运行sudo yum install nodejs npm。
4、验证是否生效：执行which node与which npm，输出应为/usr/bin/node和/usr/bin/npm；若仍报错，请检查$PATH是否包含/usr/bin，可通过echo $PATH确认。
二、通过NodeSource仓库安装指定LTS版本（推荐稳定生产环境）
NodeSource提供经签名验证的二进制包，版本更新及时且兼容性经过测试，能绕过系统仓库陈旧版本问题。
1、Ubuntu/Debian LTS系统：下载并执行LTS源配置脚本curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -。
2、CentOS/RHEL系统：运行curl -sL https://rpm.nodesource.com/setup_lts.x | sudo bash -。
3、更新包索引并安装：Ubuntu/Debian执行sudo apt-get install -y nodejs；CentOS/RHEL执行sudo yum install -y nodejs。
4、安装后自动写入/usr/bin/node和/usr/bin/npm，无需手动配置PATH；但需注意：部分旧版CentOS可能将npm单独打包，如提示npm: command not found，请额外执行sudo yum install -y npm。
三、使用nvm管理多版本Node.js（适合开发者日常切换）
nvm在用户级隔离Node.js版本，不修改系统路径，所有文件存于~/.nvm，避免权限冲突与全局污染。
1、安装nvm：执行curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash。
2、重载shell配置：对bash用户运行source ~/.bashrc，对zsh用户运行source ~/.zshrc。
3、列出可用LTS版本：nvm list-remote --lts，输出类似v20.12.2、v18.20.4等。
4、安装并设为默认：nvm install --lts后立即执行nvm alias default 'lts/*'。
5、验证：运行nvm use default，再执行node -v与npm -v；此时which node将指向~/.nvm/versions/node/vXX.X.X/bin/node，该路径已由nvm自动注入$PATH。
四、手动解压二进制包并配置环境变量（适用于离线或定制路径场景）
此方法完全控制安装位置，所有文件集中于自定义目录，适合容器化部署或严格权限管控环境。
1、下载对应架构的tar.xz包：例如wget https://nodejs.org/dist/v20.12.2/node-v20.12.2-linux-x64.tar.xz。
2、解压至/opt：sudo tar -xf node-v20.12.2-linux-x64.tar.xz -C /opt，生成目录/opt/node-v20.12.2-linux-x64。
3、创建软链接统一入口：sudo ln -s /opt/node-v20.12.2-linux-x64/bin/node /usr/local/bin/node，同理链接npm：sudo ln -s /opt/node-v20.12.2-linux-x64/bin/npm /usr/local/bin/npm。
4、若需全局生效且不依赖软链接，可编辑/etc/profile（系统级）或~/.bashrc（用户级），追加以下两行：
export NODE_HOME=/opt/node-v20.12.2-linux-x64
export PATH=$NODE_HOME/bin:$PATH
5、使配置生效：source /etc/profile或source ~/.bashrc；验证echo $NODE_HOME应输出路径，node -v应返回版本号。
五、npm全局目录与缓存路径自定义配置
默认npm全局安装路径为~/.npm-global或/usr/lib/node_modules，易引发权限错误；建议显式设置prefix与cache，避免sudo安装。
1、创建专用目录：mkdir -p $HOME/node_global $HOME/node_cache。
2、配置.npmrc文件：执行echo "prefix=$HOME/node_global" >> ~/.npmrc与echo "cache=$HOME/node_cache" >> ~/.npmrc。
3、将全局bin目录加入PATH：在~/.bashrc末尾添加export PATH=$HOME/node_global/bin:$PATH，再执行source ~/.bashrc。
4、验证配置：运行npm config get prefix应返回/home/[username]/node_global；安装全局包如npm install -g http-server后，执行http-server -v应可直接调用。
5、关键提示：务必确保$HOME/node_global/bin位于$PATH最前端，否则旧版全局命令可能优先被调用。
