GoReact 是一个结合 Go 后端和 React 前端的服务端渲染(SSR)框架，旨在提供高性能、易维护的全栈开发体验。
- 服务端渲染(SSR): 使用 Go 在服务端渲染 React 组件，提升首屏加载速度和 SEO 友好性
- 热模块替换(HMR): 开发环境支持实时预览修改效果，无需手动刷新
- 国际化支持: 内置 i18n 支持，轻松实现多语言网站
- 安全性: 默认开启各种安全头部，如 XSS 保护、内容类型保护等
- 现代化 UI: 使用 Radix UI、TailwindCSS 构建现代化界面
- 认证系统: 内置 JWT 认证机制，支持 Google OAuth
- Go 1.24+
- Gin Web 框架
- V8Go (JavaScript 运行时)
- esbuild (JS/CSS 编译)
- React 19
- Radix UI 组件库
- TailwindCSS
- TypeScript
goreact/
├── auth/ # 认证相关逻辑
├── base/ # 基础功能模块
├── cmd/ # 应用入口
├── conf/ # 配置文件
├── dao/ # 数据访问对象
├── i18n/ # 国际化支持
├── mcp/ # MCP 客户端
├── model/ # 数据模型
├── server/ # 核心服务器代码
│ ├── build.go # 构建逻辑
│ ├── esbuild.go # esbuild 集成
│ ├── hmr.go # 热模块替换
│ ├── react_render.go # React 渲染器
│ ├── server.go # 服务器配置
│ └── templates/ # HTML 模板
└── ui/ # 前端代码
├── blocks/ # UI 块组件
├── components/ # 可复用组件
├── layout/ # 布局组件
└── lib/ # 工具库
flowchart TD
A[客户端] -->|HTTP请求| B[Gin Web服务器]
B -->|路由分发| C[模板渲染器]
C -->|获取组件和数据| D[React组件]
C -->|获取用户信息| E[认证系统]
C -->|获取翻译| F[i18n国际化]
subgraph 服务端渲染
D -->|JS代码| G[V8Go引擎]
E -->|用户数据| G
F -->|翻译数据| G
G -->|执行渲染| H[生成HTML]
end
H -->|返回HTML| A
subgraph 客户端激活
A -->|接收HTML| I[展示页面]
I -->|加载JS| J[React Hydrate]
J -->|接管页面| K[交互式应用]
end
subgraph 开发流程
L[文件变更] -->|检测| M[HMR]
M -->|热更新| N[esbuild编译]
N -->|实时更新| A
end
- Go 服务器接收 HTTP 请求
- 服务器确定要渲染的 React 组件和数据
- 使用 V8 引擎在服务端执行 React 组件的渲染
- 生成 HTML 并发送到客户端
- 客户端接收并展示渲染好的 HTML
- React 在客户端"激活"(hydrate)页面，接管交互性
git clone https://github.com/daodao97/go-react-ssr-template
cd go-react-ssr-template
go mod tidy
npm i 欢迎提交 Pull Request 或提出 Issue 来改进本项目。
本项目采用 MIT 许可证。