本章节涵盖 Next.js 项目的初始化流程、构建工具配置、文件目录规范以及环境变量的安全管理,旨在构建一个可扩展、类型安全且易于维护的代码库。
1. 项目初始化
使用官方脚手架 create-next-app 是启动项目的标准方式。
建议使用最新版本以获取 Next.js 15+ 的特性支持。
初始化命令与选项建议
在终端执行以下命令启动向导:
npx create-next-app@latest
推荐的配置选项及其理由:
- TypeScript: Yes。提供静态类型检查,是大型前端项目的标配。
- ESLint: Yes。用于捕获代码错误和统一代码质量。
- Tailwind CSS: Yes。Next.js 官方推荐的样式解决方案,与框架集成度极高。
- src/ directory: Yes。将源码与根目录下的配置文件(如 package.json, next.config.ts)分离,保持项目根目录整洁。
- App Router: Yes。Next.js 的现代架构,支持 React Server Components 和流式渲染。
- Import Alias: Yes (默认为 @/*)。简化模块导入路径,避免出现 ../../components 的情况。
构建工具配置
Turbopack
Turbopack 是由 Vercel 开发的基于 Rust 的增量构建工具,旨在取代 Webpack。
- 现状:在 Next.js 15+ 中,Turbopack 已进入稳定阶段,用于开发环境 (next dev)。
- 启用方式:如果在开发模式下未默认开启,可通过命令参数显式启用
- 命令行输入