如何通过命令行安装 Node.js:详细指南
Node.js 是构建现代 Web 应用的核心工具,通过命令行安装是最直接高效的方式,本指南涵盖 Windows、macOS 和 Linux 三大系统,所有步骤均经过官方文档验证。
安装前准备
-
检查现有版本(避免冲突)
终端执行:node -v # 检查 Node.js npm -v # 检查 npm(Node 包管理器)
若已安装,建议先卸载旧版。
-
系统权限
- Windows:以管理员身份运行命令提示符
- macOS/Linux:在命令前加
sudo
获取临时权限
**二、分系统安装步骤
▍ Windows 系统
-
下载官方安装包
访问 Node.js 官网 下载 LTS(长期支持版)安装程序。 -
通过 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
最佳实践建议
-
使用版本管理工具(如
nvm
)# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash # 安装多版本并切换 nvm install 18 && nvm use 18
-
镜像加速(国内用户)
配置 npm 淘宝镜像:npm config set registry https://registry.npmmirror.com
-
安全更新
定期升级: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 获取最新解决方案。
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/7748.html