src 目录

除了在项目根目录下使用 Next.js 的特殊 apppages 目录外,Next.js 还支持将应用代码放在 src 目录下的常见模式。

这种方式将应用代码与主要位于项目根目录的配置文件分开,受到一些个人和团队的青睐。

要使用 src 目录,请将应用路由器文件夹或页面路由器文件夹分别移动到 src/appsrc/pages

一个包含 `src` 目录的示例文件夹结构

须知

  • /public 目录应保留在项目根目录中。
  • 配置文件如 package.jsonnext.config.jstsconfig.json 应保留在项目根目录中。
  • .env.* 文件应保留在项目根目录中。
  • 如果根目录中存在 apppages,则 src/appsrc/pages 将被忽略。
  • 如果使用 src 目录,您可能还需要移动其他应用文件夹,如 /components/lib
  • 如果使用中间件 (Middleware),请确保将其放在 src 目录中。
  • 如果使用 Tailwind CSS,您需要在 tailwind.config.js 文件的 content 部分 添加 /src 前缀。
  • 如果使用 TypeScript 路径导入(如 @/*),则应更新 tsconfig.json 中的 paths 对象以包含 src/