启动新Astro项目时终端出现“error fetch failed”错误求助

算力阿峰

2026-7-26

解决 npm create astro@latest 执行时的 fetch failed 错误

以下是几种可行的解决方法，按优先级尝试：

检查网络连接与npm registry可达性
运行 npm ping 测试是否能正常连接npm官方源。如果返回失败，切换到稳定网络（比如关闭代理、切换到手机热点）后重试。
清理npm缓存
缓存损坏可能导致资源下载失败，执行命令：
```
npm cache clean --force
```
清理完成后重新运行创建命令。
切换npm镜像源
国内网络访问官方源可能不稳定，切换到国内镜像：
```
npm config set registry https://registry.npmmirror.com/
```
设置完成后再次执行 npm create astro@latest。
检查目标目录权限
错误中显示的路径 /Users/<my.username> 需要确保当前用户拥有读写权限。如果权限不足，可以通过命令修改权限（以macOS为例）：
```
sudo chown -R $USER:$USER /Users/<my.username>
```
升级npm到最新版本
旧版npm可能存在兼容性问题，执行升级命令：
```
npm install -g npm@latest
```
升级完成后重试创建操作。
手动安装并运行create-astro
如果上述方法都无效，直接全局安装create-astro包再执行：
```
npm install -g create-astro
create-astro
```