Windows10下Git Bash执行npm install遇EACCES权限拒绝问题求助

1. 清理项目残留与npm缓存 #

• 删除项目目录下的node_modules文件夹和package-lock.json文件：

  rm -rf node_modules package-lock.json
  

• 强制清理npm缓存：

  npm cache clean --force
  

2. 以管理员身份运行Git Bash #

右键Git Bash图标，选择以管理员身份运行，进入项目目录后重新执行npm install。Windows桌面目录的权限限制可能导致普通权限无法创建文件。

3. 调整NVM与Node版本 #

• 检查C:\Users\Hamza\.nvm目录权限：右键该文件夹→属性→安全→编辑，确保当前用户拥有完全控制权限。
• 切换到Node LTS版本（如v20.x）测试，新版本Node可能存在Windows环境兼容性问题：

  nvm install 20
  nvm use 20
  

4. 配置npm全局路径（规避系统权限冲突） #

• 创建用户专属的npm全局目录：

  mkdir ~/.npm-global
  

• 设置npm全局前缀指向该目录：

  npm config set prefix '~/.npm-global'
  

• 将全局目录添加到环境变量，重启Git Bash生效：

  echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
  

5. 检查项目目录权限 #

右键项目文件夹（C:\Users\Hamza\Desktop\Project）→属性→安全→编辑，确保当前用户拥有读取、写入、修改权限，必要时勾选“完全控制”。

6. 临时关闭Windows Defender实时保护 #

部分安全软件会拦截npm创建文件操作，临时关闭实时保护后执行npm install，验证是否为安全软件导致的权限问题。

完成上述步骤后，重新执行npm install，随后尝试npm start启动服务器。

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