NextJS中文文档 - Src Folder
作为在项目根目录中放置特殊的 Next.js app
或 pages
目录的替代方案,Next.js 还支持将应用程序代码放在 src
文件夹下的常见模式。
这将应用程序代码与大多数位于项目根目录中的项目配置文件分开,这是一些个人和团队所偏好的方式。
要使用 src
文件夹,将 app
路由器文件夹或 pages
路由器文件夹分别移至 src/app
或 src/pages
。
须知:
/public
目录应保留在项目的根目录中。- 配置文件如
package.json
、next.config.js
和tsconfig.json
应保留在项目的根目录中。.env.*
文件应保留在项目的根目录中。- 如果根目录中存在
app
或pages
,则src/app
或src/pages
将被忽略。- 如果您使用
src
,您可能还会移动其他应用程序文件夹,如/components
或/lib
。- 如果您使用中间件,请确保将其放在
src
文件夹内。- 如果您使用 Tailwind CSS,您需要在
tailwind.config.js
文件的 content 部分中添加/src
前缀。- 如果您使用 TypeScript 路径来导入,例如
@/*
,您应该更新tsconfig.json
中的paths
对象以包含src/
。
版本历史
版本 | 变更 |
---|---|
v9.0.0 | 引入 src 文件夹。 |