56 lines
1.1 KiB
Markdown
56 lines
1.1 KiB
Markdown
# ADR-0002: 采用 Next.js 作为前端框架
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| **状态** | 已接受 |
|
||
| **创建日期** | 2026-05-25 |
|
||
| **决策者** | 架构师 |
|
||
| **最后更新** | 2026-05-25 |
|
||
|
||
## 上下文
|
||
|
||
需要选择一个现代的前端框架，要求支持 SSR、TypeScript，有丰富的生态系统。
|
||
|
||
## 决策
|
||
|
||
采用 Next.js 14+ 作为前端框架。
|
||
|
||
## 理由
|
||
|
||
### 为什么选择 Next.js
|
||
|
||
| 优势 | 说明 |
|
||
|------|------|
|
||
| SSR/SSG 支持 | 提升 SEO 和首屏加载速度 |
|
||
| App Router | 现代化路由架构 |
|
||
| API Routes | 前后端一体化 |
|
||
| 国内生态良好 | Ant Design、Tailwind 支持好 |
|
||
|
||
## 替代方案考虑
|
||
|
||
### 方案 1: Vite + React
|
||
|
||
| 优势 | 劣势 |
|
||
|------|------|
|
||
| 更轻量、更快 | 缺少内置 SSR |
|
||
|
||
**不选择理由**: 需要自己配置 SSR、路由等，增加复杂度。
|
||
|
||
## 后果
|
||
|
||
### 正面后果
|
||
|
||
- 开箱即用的 SSR 支持
|
||
- 丰富的插件生态
|
||
- 良好的开发体验
|
||
|
||
### 负面后果
|
||
|
||
- 有一定学习曲线
|
||
- 相对较重
|
||
|
||
---
|
||
|
||
> **变更记录**
|
||
> 2026-05-25: 初始创建，状态设为已接受
|