必须确保命令行工具可用、包管理器就位并正确配置path,否则node/npm会提示“command not found”;推荐fnm安装(自动配置path)、次选homebrew或官网.pkg(需手动补path),并须配置npm全局目录防eacces错误。

要在Mac终端中安装Node.js环境,必须确保命令行工具可用、包管理器就位,并正确配置可执行路径,否则即使安装完成,node或npm命令也会提示“command not found”。
确认系统与Shell基础环境
打开终端,先执行sw_vers确认macOS版本不低于10.10;再运行echo $SHELL查看当前shell——2026年新装Mac默认为zsh,旧系统可能仍用bash,这将决定后续配置文件路径。
执行which node && which npm。若返回空行,说明未安装;若已有输出,建议先卸载旧版本再继续,避免路径冲突。
方法一:用Homebrew安装(推荐给已有Homebrew用户)
Homebrew会自动把node和npm链接到/opt/homebrew/bin(Apple Silicon)或/usr/local/bin(Intel),并更新PATH。
第一步:在终端中粘贴并运行安装命令:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
第二步:安装完成后执行brew update刷新软件索引,再运行brew install node——该命令同时安装Node.js和配套npm。
第三步:验证安装结果:node -v && npm -v。输出类似v20.11.1和10.2.4即成功。若报错“command not found”,说明PATH未生效,需进入下一环节手动补全。
方法二:用fnm快速安装(强烈推荐新用户)
fnm是专为macOS优化的Node版本管理器,原生支持Apple Silicon芯片,无需sudo权限,安装后自动注入PATH,适合日常开发与多版本切换。
在终端中执行:curl -fsSL https://fnm.vercel.app/install | bash。
按提示将fnm初始化代码追加到~/.zshrc(或~/.bash_profile),然后运行source ~/.zshrc重载配置。
【关键操作】执行fnm install --lts && fnm default --lts——这一步会安装最新LTS版并设为默认,同时自动注册全局bin路径,无需额外配置PATH。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
最后运行node -v和npm -v,两行版本号同时出现即表示环境已就绪。
方法三:官网.pkg图形化安装后补PATH(适合不熟悉命令行者)
此方式安装程序会尝试写入/usr/local/bin,但macOS 12.6+及zsh环境下常因Shell缓存导致命令不可用,必须手动干预。
访问https://nodejs.org/zh-cn/,点击页面中明确标注“LTS”的蓝色下载按钮,下载macOS .pkg安装包。
双击安装包,全程点击“继续”→“安装”,过程中需输入管理员密码授权。
安装完毕后,**不要立即验证**,先关闭所有终端窗口,再重新打开一个——这是为了清空zsh对PATH的旧缓存。
执行which node,若返回/usr/local/bin/node,说明路径已注册;若为空,则需编辑~/.zshrc,在末尾添加:export PATH="/usr/local/bin:$PATH",保存后运行source ~/.zshrc。
验证npm全局模块写入权限(防报错关键步骤)
npm默认向/usr/local写全局模块,macOS系统限制该目录写权限,直接npm install -g会触发EACCES错误。
创建用户级全局目录:mkdir ~/.npm-global。
配置npm使用该目录:npm config set prefix '~/.npm-global'。
将~/.npm-global/bin加入PATH:在~/.zshrc末尾追加export PATH=~/.npm-global/bin:$PATH,然后执行source ~/.zshrc。
验证配置是否生效:npm config get prefix应输出/Users/你的用户名/.npm-global。










