快速入门

前提条件

  • Node.js 18+ 或 20+(使用项目本地版本)

  • npm (随 Node.js 一同安装)

安装

cd ~/Projects/fgai/www
npm install

环境变量

复制示例文件并根据需要进行调整:

cp .env.example .env.local

变量

默认值

说明

STRAPI_URL

http://localhost:1337

Strapi CMS 基础 URL

NEXT_PUBLIC_SITE_URL

http://localhost:3000

站点公开 URL(用于 SEO)

本地运行

需要启动两个进程:模拟 Strapi 服务器和 Next.js 开发服务器。

终端 1 --- 模拟 Strapi:

node scripts/mock-strapi.mjs

这将在端口 1337 上启动一个轻量级 API 服务器,提供 20 篇文章(9 篇功能文章 + 11 篇边界情况测试文章)、1 个分类、16 个标签和 1 位作者。详情请参阅 数据填充与测试

终端 2 --- Next.js:

npm run dev

在浏览器中打开 http://localhost:3000。中间件会自动重定向到 /en (或浏览器的首选语言环境)。

运行测试

# Run once
npm test

# Watch mode
npm run test:watch

代码检查

npm run lint

可用的 npm 脚本

脚本

说明

dev

启动 Next.js 开发服务器(端口 3000)

build

生产环境构建

start

启动生产环境服务器

lint

运行 ESLint

test

运行一次 Vitest

test:watch

以监视模式运行 Vitest