Windows10 WSL环境执行npm install报EACCES权限错误如何解决

问题根源 #

你遇到的报错由两个独立问题共同导致：

• WSL挂载Windows目录（/mnt/c路径）的权限冲突：你把项目放在了/mnt/c下的OneDrive同步目录，Windows NTFS文件系统的权限规则和WSL的Linux权限逻辑不兼容，加上OneDrive的文件同步锁，直接导致npm重命名文件时被系统拒绝。
• Node.js版本过旧：你当前安装的Node 10.19.0是Ubuntu官方源的默认老旧版本，不符合npm 8+要求的最低Node 12.13.0的版本要求，同时全局安装路径和常规Linux自定义安装路径不同，所以你找不到/usr/local/lib相关目录，修改权限的命令自然无效。

操作步骤 #

步骤1：将项目迁移到WSL原生文件系统（必做，优先级最高） #

WSL原生目录（/home/当前用户名路径下）的权限规则完全符合Linux标准，不会出现跨系统权限冲突，也不会被OneDrive同步逻辑锁文件：

• 在WSL终端执行以下命令，创建专属项目目录：

  mkdir ~/react-projects
  

• 将原/mnt/c下的项目文件移动到该目录，或者直接在该目录下重新克隆教程提供的项目代码。

步骤2：卸载旧版Node，使用nvm管理Node版本（彻底解决全局权限问题） #

系统自带的老旧Node版本安装路径在/usr/bin下，且权限绑定root用户，修改chown也容易引发其他问题，用nvm可以完全规避全局权限冲突：

1. 卸载系统自带的Node和npm：

   sudo apt remove --purge nodejs npm -y && sudo apt autoremove -y
   

2. 安装nvm（Node版本管理器）：

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   

3. 重载终端配置让nvm生效：

   # 用bash执行下面的命令
   source ~/.bashrc
   # 如果用zsh则执行下面的命令
   # source ~/.zshrc
   

4. 安装长期支持版Node（以18 LTS为例，完全兼容当前React项目要求）：

   nvm install 18
   

   安装完成后nvm会自动将该版本设为默认，所有全局包权限都属于当前用户，不需要额外修改权限。

步骤3：重新执行安装依赖 #

进入迁移后的项目目录，先删除残留的错误文件，再安装依赖：

rm -rf node_modules package-lock.json
npm install

临时解决方案（不推荐） #

如果必须把项目放在Windows目录下，可以在执行npm install时添加参数跳过权限校验：

npm install --unsafe-perm

该方案仅能临时解决安装报错，后续大概率会遇到热更新失效、文件写入报错等问题，仅做临时测试使用。

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