命令行安装Node.js是开发者日常工作中常见的操作,尤其对于需要在服务器、Docker容器或远程环境中部署Node.js应用的场景而言,掌握命令行安装方法至关重要,本文将详细介绍在不同操作系统(Linux、macOS、Windows)下通过命令行安装Node.js的步骤、注意事项及常见问题,帮助开发者高效完成环境配置。

Linux系统下的命令行安装
Linux系统是Node.js开发的主流环境之一,常见的发行版如Ubuntu、CentOS等,其安装方式略有差异,以Ubuntu为例,推荐使用NodeSource提供的官方源进行安装,确保获取最新稳定版本,更新系统包列表并安装必要的依赖工具:
sudo apt update sudo apt install -y curl
根据需要的Node.js版本(如LTS版本18.x)添加NodeSource源:
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
通过包管理器安装Node.js:
sudo apt install -y nodejs
安装完成后,验证版本:

node -v npm -v
对于CentOS系统,需先将NodeSource源添加到yum仓库,再执行sudo yum install -y nodejs,若需管理多个Node.js版本,可配合nvm(Node Version Manager)使用,通过nvm install 18等命令灵活切换版本。
macOS系统下的命令行安装
macOS用户可通过Homebrew包管理器快速安装Node.js,首先确保已安装Homebrew(可通过/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装),然后执行:
brew install node
Homebrew会自动安装Node.js及其依赖的最新LTS版本,若需指定版本,可使用brew install node@18,并通过brew link node@18建立符号链接,同样,nvm在macOS下也广泛使用,安装后通过nvm install --lts获取长期支持版本。
Windows系统下的命令行安装
Windows系统下,开发者可通过PowerShell或命令提示符使用Chocolatey包管理器安装Node.js,首先安装Chocolatey(以管理员身份运行PowerShell,执行Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))),然后执行:

choco install nodejs-lts
若需使用nvm for Windows,可从GitHub项目下载安装包,通过nvm install 18安装指定版本,需注意,Windows下Node.js的路径可能需要添加到系统环境变量中。
安装后的配置与验证
安装完成后,建议配置npm的全局模块安装路径,避免权限问题,在Linux/macOS下,可创建.npmrc文件并添加prefix=${HOME}/.npm-global,然后将~/.npm-global/bin添加到PATH环境变量,Windows下则需在系统环境变量中新建NODE_PATH并配置路径。
验证安装时,可通过node -v检查Node.js版本,npm -v检查npm版本,并尝试运行一个简单的Node.js脚本(如console.log('Hello, Node.js!'))确保环境可用。
常见问题与解决方案
- 权限问题:在Linux/macOS下全局安装npm模块时可能提示权限不足,可通过
sudo npm install -g <package>临时解决,但更推荐配置npm全局路径以避免频繁使用sudo。 - 版本冲突:项目中可能需要特定版本的Node.js,建议使用
nvm管理多版本,通过nvm use <version>切换,或在项目中创建.nvmrc文件指定版本。
相关问答FAQs
Q1: 如何卸载通过命令行安装的Node.js?
A1: Linux/macOS下,若通过包管理器安装(如apt、brew),可执行sudo apt purge nodejs或brew uninstall node;若使用nvm,直接通过nvm uninstall <version>即可,Windows下可通过控制面板的“程序和功能”卸载,或使用Chocolatey执行choco uninstall nodejs-lts。
Q2: 安装Node.js后npm命令不可用怎么办?
A2: 首先检查npm是否已正确安装(执行npm -v),若提示“command not found”,可能是PATH环境变量未包含npm的安装路径,Linux/macOS下可通过echo $PATH检查,并将/usr/local/bin(默认路径)或自定义的全局路径添加到.bashrc或.zshrc文件中,Windows下需在系统环境变量的“Path”中添加Node.js和npm的安装目录(如C:\Program Files\nodejs),然后重启终端。
