Mac系统hexo-cli安装失败及yarn安装后命令无法识别求助

针对你遇到的两个核心问题——npm全局安装的权限报错，以及yarn安装后hexo命令找不到的问题，我整理了几个可行的解决步骤：

一、先解决Yarn安装后Hexo命令找不到的问题 #

Yarn虽然显示安装成功，但系统找不到hexo命令，是因为Yarn的全局bin目录没在你的系统PATH里。按以下步骤操作：

1. 先获取Yarn全局包的bin路径，执行命令：

   yarn global bin
   

   你会得到类似/Users/judy/.yarn/bin的路径（根据你的用户名不同会有变化）。
2. 将这个路径添加到系统环境变量中：
   • 如果你用的是Bash，编辑~/.bash_profile文件，添加一行：

     export PATH="$PATH:$(yarn global bin)"
     

   • 如果你用的是Zsh，编辑~/.zshrc文件，添加同样的内容。
3. 让环境变量生效，执行：

   # Bash用户
   source ~/.bash_profile
   # Zsh用户
   source ~/.zshrc
   

4. 现在再执行hexo -v，应该就能正常识别命令了。

二、修复npm全局安装的权限问题（避免后续再踩坑） #

你之前用npm安装时出现权限报错，甚至sudo都没用，本质是因为全局包目录的所有权问题，不推荐用sudo安装全局包，会导致后续更多权限混乱。正确的做法是修改npm的全局包安装目录：

1. 创建一个属于你用户的全局包目录：

   mkdir ~/.npm-global
   

2. 配置npm使用这个新目录：

   npm config set prefix '~/.npm-global'
   

3. 将这个目录的bin路径添加到环境变量，同样编辑~/.bash_profile或~/.zshrc，添加：

   export PATH=~/.npm-global/bin:$PATH
   

4. 生效环境变量后，再执行npm install -g hexo-cli就不会再出现权限报错了。

三、更省心的长期方案：用NVM管理Node.js版本 #

如果不想折腾环境变量和权限，推荐使用**NVM（Node Version Manager）**来管理Node.js版本。NVM会把Node和全局包都安装在用户目录下，彻底避免权限问题：

1. 安装NVM后，重新安装你需要的Node.js v8.9.1：

   nvm install 8.9.1
   nvm use 8.9.1
   

2. 之后直接执行npm install -g hexo-cli或者yarn global add hexo-cli，都不会有任何权限问题，命令也能直接被系统识别。

补充说明为什么sudo没用 #

用sudo安装全局包时，包的文件所有权会变成root用户，后续普通用户运行或更新这些包时会有权限问题；同时，root用户的PATH可能和你的普通用户PATH不一致，就算装成功了也可能找不到命令，所以尽量避免用sudo安装npm/yarn的全局包。

内容的提问来源于stack exchange，提问作者user6080689