npm - The configured global bin directory "xxx" is not in PATH 报错原因是什么?

Question

1.在任意目录下执行
pnpm ls -g

ERROR  The configured global bin directory "/xxx" is not in PATHFor help, run: pnpm help list

2.在存在pnpm-lock文件的项目下执行：pnpm ls -g 结果不报错
请问是什么原因造成报错的呢？

Answer 1

这个问题涉及到 pnpm 的全局安装和环境变量 PATH 的配置。当你尝试在全局安装 pnpm 的情况下执行 pnpm ls -g，而全局的 bin 目录不在你的 PATH 环境变量中时，就会出现这个错误。

具体来说，当你执行 pnpm ls -g 时，pnpm 会尝试查找并执行全局安装的包的全局 bin 脚本。这些脚本通常位于全局的 node_modules/.bin 目录中。如果这个目录不在你的 PATH 环境变量中，系统就无法找到并执行这些脚本，从而导致这个错误。

在存在 pnpm-lock 文件的项目下执行 pnpm ls -g 结果不报错的原因是因为在这个项目中，node_modules/.bin 目录是在项目特定的 PATH 中的。当你在项目中执行命令时，系统会首先查找当前项目的 node_modules/.bin 目录，因此不会出现找不到全局 bin 脚本的问题。

要解决这个问题，你可以将全局的 node_modules/.bin 目录添加到你的 PATH 环境变量中。具体操作方法取决于你的操作系统和 shell。以下是一些常见的方法：

• 在 Windows 上，你可以将以下内容添加到你的系统环境变量中：

  %APPDATA%\npm\bin

• 在 macOS 或 Linux 上，你可以在 shell 的配置文件（例如 .bashrc、.bash_profile 或 .zshrc）中添加以下内容：

  export PATH=$PATH:/path/to/npm/bin

注意，你需要将 /path/to/npm/bin 替换为你系统中 npm（或 pnpm）的全局安装路径。如果你不确定这个路径，可以尝试在终端中执行 npm root -g 或 pnpm root -g 来获取。