Menu

src Directory

作为在项目根目录下使用特殊的 Next.js app 或 pages 目录的替代方案，Next.js 还支持将应用程序代码放置在 src 目录下这一常见模式。

这种做法将应用程序代码与大多位于项目根目录的项目配置文件分开，某些个人和团队更倾向于这种方式。

要使用 src 目录，只需将 app 路由文件夹或 pages 路由文件夹分别移动到 src/app 或 src/pages。

使用 `src` 目录的示例文件夹结构

值得注意的是：

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