November 27, 2024

MacOS安装执行npm install出现npm fund问题详述

使用 npm 安装 Hexo CLI

打开终端,使用以下命令安装 Hexo CLI:

1
$ sudo npm install -g hexo-cli

这个命令会将 Hexo CLI 安装为全局命令,你可以在任何目录下运行 Hexo。

注意:

​ • 在使用 sudo 执行命令时,会要求输入管理员密码。请确保你的 macOS 用户有管理员权限。

​ • 如果安装过程中提示权限问题或安装失败,可以尝试清除 npm 缓存并重新安装。

检查安装是否成功

安装完成后,检查 Hexo 是否安装成功: hexo -v

如果成功,会显示 Hexo 版本信息,类似于以下输出:

1
2
3
4
hexo-cli: 4.3.2
os: darwin 24.0.0 15.0
node: 22.11.0
npm: 9.8.0

问题 1:如果 hexo -v 提示 “command not found”

这种情况通常是由于 npm 没有正确配置环境变量,或者 Hexo CLI 没有安装成功。

解决方案:

​1.确保 npm 和 Node.js 已正确安装。再次运行以下命令:

1
2
node -v
npm -v

2.确保 npm 安装路径已经添加到系统的环境变量中。可以通过以下命令查看 npm 安装路径:

1
which npm

3.如果路径正确,但依然无法使用 hexo 命令,尝试通过以下命令重新安装 Hexo:

1
sudo npm install -g hexo-cli

问题 2:安装过程中的报错信息

如果在安装过程中遇到类似以下的错误信息:

1
2
changed 53 packages in 48s
14 packages are looking for funding

这只是 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
2
sudo npm uninstall -g hexo-cli
sudo npm install -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
2
source ~/.zshrc   # 如果你使用的是 Zsh
source ~/.bash_profile # 如果你使用的是 Bash

​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.

#web#develop#debug#macOS