17370845950

如何在Mac上安装Node.js和NPM?(前端开发环境)
最推荐在Mac上使用fnm安装Node.js和NPM,因其轻量、快速、原生支持Apple Silicon;执行curl安装命令、配置shell、安装LTS版并验证版本即可完成,图形化方式可选官网.pkg但不便版本管理。

在Mac上安装Node.js和NPM最推荐的方式是使用版本管理工具fnm(Fast Node Manager),它轻量、快速、原生支持Apple Silicon(M1/M2/M3芯片),比nvm更简洁,也比直接下载.pkg安装更利于后续升级和多版本切换。

用fnm一键安装Node.js和NPM

fnm会自动安装最新LTS版Node.js(含配套NPM),全程命令行操作,无需图形界面:

  • 打开终端(Terminal),运行安装命令:
    curl -fsSL https://fnm.vercel.app/install | bash
  • 按提示将fnm加入shell配置(如~/.zshrc),然后重载配置:
    source ~/.zshrc
  • 安装并设为默认版本:
    fnm install --lts && fnm use --lts && fnm default --lts
  • 验证是否成功:
    node -vnpm -v 应分别输出版本号(如 v20.11.1 和 10.2.4)

如果偏好图形化安装(适合新手)

可前往nodejs.org官网,下载「macOS Installer (.pkg)」文件(推荐选LTS版本):

  • 双击.pkg按向导完成安装,系统会自动把Node.js和NPM添加到/usr/local/bin
  • 安装后重启终端,运行which nodewhich npm确认路径存在
  • 注意:这种方式默认无法轻松切换Node版本,升级需重新下载安装包

验证与基础配置(安装后必做)

装完别急着写代码,先检查环境并优化常用设置:

  • 确认全局模块安装路径:
    npm config get prefix(通常为/usr/local~/.local/share/fnm/...
  • 把npm全局bin目录加入$PATH(fnm已自动处理;若用.pkg安装,可能需要手动加:
    echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
  • 换国内镜像加速(尤其npm install时):
    npm config set registry https://registry.npmmirror.com

常见问题快速排查

遇到命令未找到或权限错误,大概率是路径或权限问题:

  • command not found: node → 检查source ~/.zshrc是否执行,或确认shell类型(echo $SHELL
  • permission denied(全局安装报错)→ 不要用sudo npm install -g,改用fnm或修复npm权限:
    mkdir ~/.npm-global && npm config set prefix ~/.npm-global && echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
  • M1/M2 Mac上某些包编译失败 → 先运行softwareupdate --install-rosetta(按提示安装Rosetta),再重试

基本上就这些。用fnm安装,5分钟内搞定干净可用的前端开发环境,后续切版本、升Node、配镜像都方便。不复杂但容易忽略的是PATH配置和镜像设置——这两步补上,日常开发基本不会卡在环境上。