跳到内容

src 目录

作为在项目根目录中设置特殊的 Next.js apppages 目录的替代方案,Next.js 也支持将应用程序代码放置在 src 目录下的常用模式。

这将应用程序代码与项目配置文件分开,项目配置文件通常位于项目根目录中,这受到一些个人和团队的偏好。

要使用 src 目录,请将 app Router 文件夹或 pages Router 文件夹分别移动到 src/appsrc/pages

An example folder structure with the `src` directory

须知:

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