手动添加文件夹后Next.js项目崩溃，dev服务器无法启动求助

以下是几个常见的排查方向和解决方法：

• 清理项目缓存
  Next.js和TypeScript的缓存可能残留了旧文件夹的引用，就算删除文件夹也会导致编译失败。执行以下命令彻底清理缓存后重启：

  rm -rf .next/ node_modules/.cache/
  npm install
  npm run dev
  

  或者直接用Next.js内置的清缓存命令：

  npm run dev -- --clear-cache
  

• 检查TypeScript配置与缓存

  1. 打开tsconfig.json，确认paths配置里有没有指向旧util文件夹的别名（比如"@/util/*": ["./util/*"]），如果有修改后保存，重启开发服务。
  2. 删除项目根目录的tsconfig.tsbuildinfo文件，这是TypeScript的编译缓存文件，删除后重新执行npm run dev让TS重新编译。

• 排查残留代码引用
  全局搜索项目中所有文件，查找是否有引用旧util文件夹的导入语句（比如import { xxx } from '../util'）。这些无效引用会导致编译报错，找到后修正或删除对应的代码。

• 检查依赖与锁文件
  查看package.json和package-lock.json（或yarn.lock）是否有异常内容，比如误添加的依赖、错误的脚本配置。如果有异常，删除锁文件后重新执行npm install，再启动服务。

• 文件权限问题（Linux/macOS环境）
  如果是在类Unix系统下，添加文件夹时可能设置了错误的文件权限，导致Next.js无法读取文件系统。可以执行以下命令修复权限：

  chmod -R 755 ./
  

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