快速入门¶
前提条件¶
Node.js 18+ 或 20+(使用项目本地版本)
npm (随 Node.js 一同安装)
安装¶
cd ~/Projects/fgai/www
npm install
环境变量¶
复制示例文件并根据需要进行调整:
cp .env.example .env.local
变量 |
默认值 |
说明 |
|---|---|---|
|
|
Strapi CMS 基础 URL |
|
|
站点公开 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 脚本¶
脚本 |
说明 |
|---|---|
|
启动 Next.js 开发服务器(端口 3000) |
|
生产环境构建 |
|
启动生产环境服务器 |
|
运行 ESLint |
|
运行一次 Vitest |
|
以监视模式运行 Vitest |