使用Prismic+NextJS模板报错：Module not found: Can't resolve '@/prismicio'

以下是针对该报错的排查与解决步骤：

• 检查路径别名配置：Next.js 中的@/别名需要在jsconfig.json或tsconfig.json中定义。确认项目根目录存在该文件，且包含如下配置：

  {
    "compilerOptions": {
      "baseUrl": ".",
      "paths": {
        "@/*": ["src/*"]
      }
    }
  }
  

  若为 TypeScript 项目，需确保tsconfig.json的include数组包含src/**/*。

• 确认目标文件存在：检查项目src目录下是否有prismicio文件夹或对应文件（如prismicio.ts/prismicio.js）。若文件缺失，大概率是模板拉取不完整，可尝试重新初始化项目。

• 清理依赖缓存并重装：
  执行以下命令重置依赖：

  rm -rf node_modules package-lock.json yarn.lock
  npm install
  # 或使用 yarn/pnpm
  yarn install
  pnpm install
  

• 重启开发服务器：缓存可能导致路径解析异常，停止当前npm run dev进程后重新启动。

• 核查Vercel部署配置：若部署时出现该问题，确认Vercel的构建命令正确，且jsconfig.json/tsconfig.json已上传至仓库，未被.gitignore排除。

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