node.js报错:npm ERR code EPERM的解决过程

下面是针对npm ERR code EPERM报错的解决攻略：

问题分析

首先，我们需要明确该错误的意思和原因。

• npm：node.js的包管理器。
• ERR：错误的缩写。
• code EPERM：访问权限错误。

因此，简单来说，这个错误提示表示我们试图访问某些文件或目录的权限不足，通常是由于缺少管理员权限或文件系统权限问题导致的。这种情况下，npm 可能会拒绝执行安装、卸载或更新等操作。

解决方法

下面是几种常见的解决办法：

1. 使用管理员身份运行命令

首先，确保拥有管理员权限。如果是在 Windows 上，则需要使用管理员身份打开 PowerShell 或命令提示符窗口。如果是在 Linux 或 macOS 上，则需要使用 sudo 命令。例如：

# Windows 上以管理员身份运行 PowerShell
PS C:\> Start-Process powershell -Verb runAs

# Linux or macOS 通过sudo以管理员身份运行npm
$ sudo npm install xxx --global

2. 修改权限

如果你已经拥有管理员权限，但还是遇到该错误，则需要检查文件或目录并修改相关权限。例如：

# 检查文件所有者
$ ls -l /usr/local/lib/node_modules

# 修改所有者
$ sudo chown -R $USER /usr/local/lib/node_modules

# 检查文件权限
$ ls -ld /usr/local/lib/node_modules

# 修改文件权限
$ sudo chmod -R 777 /usr/local/lib/node_modules

3. 修改npm全局包目录

如果上面两种方法都没解决，那么可以考虑修改 npm 的全局包目录（prefix）。默认情况下，npm 全局安装包存储在 /usr/local/lib/node_modules 目录下，因此，可能会遇到权限问题。可以通过 npm config 命令来修改该目录：

# 新建npm全局包目录
$ mkdir ~/.npm-global

# 设置npm全局包目录
$ npm config set prefix '~/.npm-global'

# 将npm全局包目录路径添加到你的环境变量 $PATH 上
export PATH=~/.npm-global/bin:$PATH

# 将以上环境变量配置添加到 `.bashrc` 或 `.zshrc` 文件中，以便每次登录时都能自动设置环境变量。

这样，所有的全局包都将被安装到 ~/.npm-global 目录中，该目录下的文件都只属于当前用户，就不会再出现拒绝访问的问题了。

示例说明

示例一

在 Windows 上运行Node.js程序，并执行 npm install 命令时，出现如下错误：

npm ERR! code EPERM
npm ERR! syscall access
npm ERR! path C:\Program Files\nodejs\node_modules\create-react-app
npm ERR! errno -4048
npm ERR! Error: EPERM: operation not permitted, access 'C:\Program Files\nodejs\node_modules\create-react-app'

分析该错误提示，我们可以发现，是因为在默认的安装目录下，当前用户缺少对 create-react-app 模块的访问权限。这时，可以以管理员身份运行 PowerShell，再执行命令，或将目录所有者修改为当前用户。

示例二

当在 Linux 或 macOS 上使用 npm install 安装某些全局包时，可能会遇到如下错误：

npm ERR! code EACCES
npm ERR! syscall symlink
npm ERR! path ../lib/node_modules/n
npm ERR! dest /usr/bin/n
npm ERR! errno -13
npm ERR! Error: EACCES: permission denied, symlink '../lib/node_modules/n' -> '/usr/bin/n'

这是因为默认情况下，npm 全局安装包存储在 /usr/local/lib/node_modules 目录下，虽然可全局访问，但普通用户缺乏访问权限。因此，要想解决该问题，可以将 npm 全局包目录修改为个人目录下的 ~/.npm-global 目录，避免权限问题。