运行npm create vite@latest时遭遇EPERM权限错误求助

问题分析 #

错误显示无法将模板文件复制到/data/Documents/vite-project/.gitignore，核心原因是当前用户对目标目录没有足够的写入权限，或npx缓存存在异常。

解决方案 #

1. 检查并修复目标目录权限 #

• 先查看目标目录（或其父目录）的权限信息：

  ls -ld /data/Documents/vite-project
  # 若目录未创建，查看父目录：ls -ld /data/Documents
  

• 如果目录所有者不是当前用户cytech，执行以下命令修改所有者：

  sudo chown -R cytech:cytech /data/Documents/vite-project
  # 若目录未创建，先创建再修改：
  mkdir -p /data/Documents/vite-project && sudo chown -R cytech:cytech /data/Documents/vite-project
  

• 同时确保目录有可写入权限：

  chmod 755 /data/Documents/vite-project
  

2. 清理npx缓存后重试 #

npx缓存异常也可能导致权限问题，执行以下命令清理缓存：

npx clear-npx-cache

清理完成后重新运行创建命令：

npm create vite@latest

3. 排查文件系统挂载问题 #

如果/data是外部挂载的文件系统（比如NTFS格式），默认挂载配置可能限制了写入权限：

• 编辑/etc/fstab文件，找到对应挂载项，添加权限参数：

  sudo nano /etc/fstab
  

• 修改挂载行，添加uid=cytech,gid=cytech,umask=0022（替换为你的用户ID和组ID），例如：

  /dev/sdb1 /data ntfs defaults,uid=cytech,gid=cytech,umask=0022 0 0
  

• 保存后重新挂载：

  sudo mount -o remount /data
  

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