使用 npm 安装 Hexo CLI
打开终端,使用以下命令安装 Hexo CLI:
1 | $ sudo npm install -g hexo-cli |
这个命令会将 Hexo CLI 安装为全局命令,你可以在任何目录下运行 Hexo。
注意:
• 在使用 sudo 执行命令时,会要求输入管理员密码。请确保你的 macOS 用户有管理员权限。
• 如果安装过程中提示权限问题或安装失败,可以尝试清除 npm 缓存并重新安装。
检查安装是否成功
安装完成后,检查 Hexo 是否安装成功: hexo -v
如果成功,会显示 Hexo 版本信息,类似于以下输出:
1 | hexo-cli: 4.3.2 |
问题 1:如果 hexo -v 提示 “command not found”
这种情况通常是由于 npm 没有正确配置环境变量,或者 Hexo CLI 没有安装成功。
解决方案:
1.确保 npm 和 Node.js 已正确安装。再次运行以下命令:
1 | node -v |
2.确保 npm 安装路径已经添加到系统的环境变量中。可以通过以下命令查看 npm 安装路径:
1 | which npm |
3.如果路径正确,但依然无法使用 hexo 命令,尝试通过以下命令重新安装 Hexo:
1 | sudo npm install -g hexo-cli |
问题 2:安装过程中的报错信息
如果在安装过程中遇到类似以下的错误信息:
1 | changed 53 packages in 48s |
这只是 npm 的提示,表示有些包需要资金支持,并不会影响 Hexo 的正常安装。如果看到类似的消息,可以忽略。
若hexo -v 依然不成功:zsh: command not found: hexo
可能是因为 hexo-cl
没有正确安装或者没有将其添加到系统的PATH
中
解决步骤:
1.检查 Hexo 是否正确安装:
确保你已经成功安装了 Hexo。如果之前的npm install -g hexo-cli
命令执行没有报错,可能是因为 hexo-cli
安装路径没有正确配置到 PATH
环境变量中。
你可以使用以下命令检查 hexo-cli
的安装位置:
1 | which hexo |
如果没有返回任何路径,说明 Hexo 没有正确安装,或者安装路径没有添加到 PATH 中。
2.重新安装 Hexo:
为了确保 Hexo 正确安装,尝试卸载并重新安装:
1 | sudo npm uninstall -g hexo-cli |
重新安装后,运行 which hexo
查看是否返回了 Hexo 安装路径。
3.确认安装路径是否在 PATH 中:
如果安装成功但是仍然找不到 hexo 命令,可能是因为 npm 安装的路径不在系统的 PATH 环境变量中。你可以通过以下命令找到 npm 全局安装路径:
1 | npm config get prefix |
然后检查hexo-cli
是否安装在该目录下,确保该目录已添加到你的 PATH 中。
如果你使用的是 macOS 或 Linux,可以通过编辑 .zshrc
或 .bash_profile
文件来添加 npm
安装路径:
1 | export PATH="$PATH:$(npm config get prefix)/bin" |
export PATH=”$PATH:$/Users/tabyang/.npm-global/bin”
修改后,运行以下命令使改动生效:
1 | source ~/.zshrc # 如果你使用的是 Zsh |
4.重新加载终端:
在执行完上述步骤后,关闭终端并重新打开,或者执行以下命令来重新加载终端配置:
1 | exec zsh |
最后再次用hexo -v
检查是否安装成功
若在添加 npm 的全局路径到 PATH的步骤中,用 echo $PATH 查看发现路径并未添加,则可能是macOS管理员权限未开通。你可以手动进入Finder路径,找到路径中 如/Users/yourname/中的 .zshrc文件(以zsh举例),然后 Command + i 找到“共享与权限”,将右下角解锁后再把其成员权限设置为“读和写”,完成操作后保存,如图:
此时重新加载后,使用如下指令检查PATH是否正确:
1 | echo $PATH |
查看输出中是否包含:
1 | /Users/tabyang/.npm-global/bin |
确认环境变量设置无误后,运行以下命令测试 Hexo 是否可用:
1 | hexo -v |
About this Post
This post is written by Tab Yang, licensed under CC BY-NC 4.0.