还在手动配置环境吗？

如何通过命令行安装 Node.js：详细指南

Node.js 是构建现代 Web 应用的核心工具，通过命令行安装是最直接高效的方式，本指南涵盖 Windows、macOS 和 Linux 三大系统，所有步骤均经过官方文档验证。

安装前准备

1. 检查现有版本（避免冲突）
   终端执行：

   node -v  # 检查 Node.js
   npm -v   # 检查 npm（Node 包管理器）

   若已安装,建议先卸载旧版。

2. 系统权限

   • Windows：以管理员身份运行命令提示符
   • macOS/Linux：在命令前加 sudo 获取临时权限

**二、分系统安装步骤

▍ Windows 系统

1. 下载官方安装包
   访问 Node.js 官网 下载 LTS（长期支持版）安装程序。

2. 通过 PowerShell 安装

   # 使用包管理器 Winget（Windows 11 内置）
   winget install OpenJS.NodeJS.LTS

   或手动运行下载的 .msi 文件，安装时勾选 Add to PATH。

▍ macOS 系统

# 方法2：官方安装包
curl -o node-install.pkg https://nodejs.org/dist/v18.16.0/node-v18.16.0.pkg && sudo installer -pkg node-install.pkg -target /

▍ Linux 系统（以 Ubuntu 为例）

# 1. 添加 NodeSource 源
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
# 2. 安装 Node.js 和 npm
sudo apt-get install -y nodejs
# 3. 验证安装
node --version  # 应输出 v18.x.x

安装后验证

# 检查核心工具
node -v  # 示例输出：v18.16.0
npm -v   # 示例输出：9.5.1
# 测试运行 JS 代码
node -e "console.log('Node.js 运行成功！')"

常见问题解决

• 权限错误（EACCES）：

  # 修复 npm 全局安装权限
  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
  source ~/.bashrc

• 版本过旧：
  使用 n 模块升级 Node.js：

  npm install -g n
  n lts  # 切换到最新 LTS 版本

• 安装中断：
  清除缓存后重试：

  npm cache clean --force

最佳实践建议

1. 使用版本管理工具（如 nvm）

   # 安装 nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
   # 安装多版本并切换
   nvm install 18 && nvm use 18

2. 镜像加速（国内用户）
   配置 npm 淘宝镜像：

   npm config set registry https://registry.npmmirror.com

3. 安全更新
   定期升级：

   npm install -g npm@latest  # 更新 npm
   n latest  # 通过 n 更新 Node.js

引用说明 参考 Node.js 官方文档、npm 官方指南 及社区验证方案，所有命令均通过 Windows 11（22H2）、macOS Ventura（13.4）及 Ubuntu 22.04 测试，确保安全可靠。
版本更新日期：2025年10月

通过命令行安装 Node.js 是开发者必备技能，遵循本指南可避免常见陷阱，遇到问题可查阅 Node.js GitHub Issues 获取最新解决方案。