Sanity项目初始化卡在「Linking Dependencies」问题求助

云上老周

2026-8-13

解决Sanity项目初始化卡在「Linking Dependencies」的问题

常见原因及对应解决方法

npm缓存异常
清理npm缓存后重新初始化：
```
npm cache clean --force
```
执行完后再运行npm create sanity@latest重试。
网络访问不稳定
国内环境下npm官方源可能存在访问问题，切换到国内镜像源：
```
npm config set registry https://registry.npmmirror.com/
```
切换完成后重新执行项目初始化命令。若后续需要切回官方源，执行：
```
npm config set registry https://registry.npmjs.org/
```
npm版本不兼容
Sanity对npm版本有一定适配要求，尝试升级到最新稳定版：
```
npm install -g npm@latest
```
或降级到已知兼容的版本（比如v18.x系列）：
```
npm install -g npm@18.17.0
```
本地残留依赖冲突
检查当前目录是否有残留的node_modules文件夹或package-lock.json文件，删除后再初始化：
```
rm -rf node_modules package-lock.json
```
Windows系统请执行：
```
rmdir /s /q node_modules
del package-lock.json
```
禁用npm进度条
进度条偶尔会导致进程卡住，关闭后重试：
```
npm config set progress false
```
之后重新运行项目初始化命令。