Turborepo项目执行npm run dev编译卡住，寻求解决方案

DevOps 小满

2026-6-19

解决Turbo项目npm run dev编译卡住的问题

清理缓存并重新安装依赖
1. 按Ctrl+C终止当前卡住的进程
2. 执行命令清理缓存和旧依赖：
```
npm cache clean --force
rm -rf node_modules package-lock.json
npx turbo clean
```
3. 重新安装依赖：
```
npm install
```
4. 再次尝试启动项目：
```
npm run dev
```
检查Node.js版本兼容性
Turbo要求使用Node.js LTS版本（推荐18.x或20.x），执行node -v查看当前版本，若版本不兼容，可通过nvm或n工具切换到兼容版本后，重复上述重新安装依赖的步骤。
禁用远程缓存
打开项目根目录的turbo.json，找到remoteCache配置段并注释或删除，示例：
```
// "remoteCache": {
//   "signature": true,
//   "teamId": "your-team-id"
// }
```
保存后重新启动项目。
排查网络问题
- 确保网络可正常访问npm包源，若存在代理限制，可关闭代理或切换到国内镜像源：
```
npm config set registry https://registry.npmmirror.com/
```
- 重新安装依赖后尝试启动项目。
查看详细日志定位卡点
执行带详细日志的启动命令，明确卡住的具体环节：
```
npm run dev -- --verbose
```
根据日志最后输出的内容，针对性排查对应依赖或编译任务。