You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用create-react-app创建React项目时出现npm EPERM错误如何解决?

解决create-react-app创建项目时的npm EPERM权限报错

该错误本质是Windows系统下npm进程缺乏C:\Users\SHOBHIT~1\AppData\Local目录的写入权限,或是目录文件被其他程序占用,可按照以下步骤依次排查解决:

  • 方案1:以管理员身份运行终端
    Windows左下角搜索cmd/PowerShell/你常用的终端工具,右键选择「以管理员身份运行」,重新执行create-react-app创建命令即可,这是优先级最高的验证方案。

  • 方案2:清理npm损坏缓存
    执行命令清理npm本地缓存后重试创建:

    npm cache clean --force
    
  • 方案3:修改npm全局路径规避C盘权限限制
    避免C盘系统目录的权限管控,可将npm的全局安装、缓存路径修改到其他非系统盘:

    1. 先在D盘(或其他非系统盘)新建两个目录,例如D:\npm\node_cache、D:\npm\node_global
    2. 执行两条命令修改npm配置:
    npm config set prefix "D:\npm\node_global"
    npm config set cache "D:\npm\node_cache"
    
    1. 修改系统环境变量:将用户变量Path下的npm默认路径替换为D:\npm\node_global,新增系统变量NODE_PATH,值设为D:\npm\node_global\node_modules,修改完成后重启终端重试。
  • 方案4:临时关闭安全软件拦截
    检查是否被Windows Defender、第三方杀毒软件、安全防护工具拦截了npm的写入操作,临时关闭实时保护功能后重试,操作完成后可重新开启防护。

  • 方案5:更换包管理器创建项目
    如果npm一直存在权限问题,可切换为yarn或pnpm完成创建:

    # 先全局安装yarn
    npm install -g yarn
    # 使用yarn创建React项目
    yarn create react-app 你的项目名称
    

补充说明:如果拉取模板速度过慢,可在创建命令后指定国内镜像源:npx create-react-app 你的项目名称 --registry https://registry.npmmirror.com

内容的提问来源于stack exchange,提问作者Shobhit Raj

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.28 06:15:02