以下是 Next.js 项目的标准创建流程,结合最佳实践和最新版本推荐:
-
环境准备
确保已安装 Node.js(建议使用最新稳定版)。在终端运行以下命令验证:
node -v(显示版本号即成功)3
npm -v(Node.js 会自带 npm)13 -
创建项目
使用官方脚手架create-next-app:bashCopy Code npx create-next-app@latest 项目名称或根据包管理器选择:
yarn create next-app或pnpm create next-app23
交互式配置选项(按需选择):- 是否使用 TypeScript
- 是否启用 ESLint(代码检查)
- 是否启用 Tailwind CSS(样式框架)
- 是否使用 **
src/目录**(源码组织方式) - 是否启用 App Router(Next.js 13+ 新版路由)
- 是否自定义导入别名 23
-
进入项目目录并启动开发服务器
bashCopy Code cd 项目名称 npm run dev项目默认运行在
http://localhost:300023 -
关键目录说明(初始结构)
- **
app/或pages/** :页面路由目录(取决于是否启用 App Router) - **
public/** :存放静态资源(图片、字体等) - **
next.config.js**:项目配置文件(可扩展 Webpack 等) 45
- **
-
常用命令
npm run dev:开发模式(热更新)npm run build:构建生产版本(生成优化代码)npm run start:启动生产服务器(需先build)npm run lint:运行 ESLint 代码检查 26
可选配置(按需添加) :
-
添加 TypeScript(若初始未选):
bashCopy Code npm install --save-dev typescript @types/react @types/node touch tsconfig.json重启
npm run dev,Next.js 会自动填充tsconfig.json2 -
样式方案:支持 CSS Modules、Tailwind CSS、Sass(需
npm install sass)或 CSS-in-JS 库(如 styled-components)23
最佳实践:建议在项目创建初期启用 TypeScript 和 ESLint 以提升代码质量与可维护性;App Router 是 Next.js 未来的发展方向,新项目推荐启用 23。