ai-blog:基于 Vue 3 与 Hono 的前后端分离个人博客项目

使用 opencode + deepseek-v4-flash 编写的个人博客

Branch1Tags0

个人博客

前后端分离的个人博客项目,支持前台访客浏览与后台管理员管理。

项目结构

blog/
├── blog-frontend/    # 前端项目(Vue 3)
├── blog-server/      # 后端项目(Hono + TypeScript)
└── 开发文档.md        # 详细开发文档

技术栈

层级 技术
前端框架 Vue 3(组合式 API + <script setup>)
构建工具 Vite
前台样式 Tailwind CSS 3
后台 UI Element Plus
路由 Vue Router 4
状态管理 Pinia
HTTP 客户端 Axios
后端框架 Hono.js(TypeScript)
数据库 SQLite3
ORM Drizzle ORM
认证 JWT(jsonwebtoken)
数据校验 zod
测试 Vitest

环境要求

工具 最低版本 建议版本
Node.js >= 18.0.0 >= 20.0.0
npm >= 9.0.0 >= 10.0.0

快速开始

一键启动(推荐)

项目根目录提供了 start.bat 脚本,可同时启动前后端开发服务器:

start.bat

启动后:

  • 后端运行在 http://localhost:3000(日志输出到 server.log)
  • 前端运行在 http://localhost:5173(日志输出到 frontend.log)
  • 按任意键即可同时停止两个服务

分别启动

后端(blog-server)

cd blog-server
npm install
# 配置环境变量
cp .env.example .env
# 生成并推送数据库表
npm run db:generate
npm run db:push
# 初始化种子数据(可选)
npm run db:seed
# 启动开发服务器(默认端口 3000)
npm run dev

2. 前端(blog-frontend)

cd blog-frontend
npm install
# 配置环境变量
# VITE_API_BASE_URL=http://localhost:3000/api
# 启动开发服务器(默认端口 5173)
npm run dev

常用脚本

前端

命令 说明
npm run dev 启动开发服务器
npm run build 构建生产版本
npm run preview 预览构建产物
npm run lint ESLint 检查
npm run format Prettier 格式化
npm run test 运行测试

后端

命令 说明
npm run dev 启动开发服务器(热重载)
npm run build 构建 TypeScript 为 JS
npm run start 生产模式启动
npm run db:generate 生成 Drizzle 迁移文件
npm run db:push 推送 Schema 到数据库
npm run db:seed 运行种子数据脚本
npm run test 运行测试

环境变量

后端(blog-server/.env)

变量名 说明 默认值
PORT 后端监听端口 3000
DATABASE_URL 数据库文件路径 ./data/blog.db
JWT_SECRET JWT 签名密钥(必填,最少 32 字符) -
CORS_ORIGIN 允许的跨域来源 http://localhost:5173

前端(blog-frontend/.env)

变量名 说明
VITE_API_BASE_URL API 基础地址,开发环境可通过 Vite 代理转发

API 文档

所有 API 以 /api/v1 为前缀,涵盖认证、文章、分类、标签、评论、设置、仪表盘、文件上传等模块。详见 开发文档.md 第 7 章。

部署架构

用户请求 → Nginx(静态文件 /api 反向代理)→ Node.js 服务(blog-server)→ SQLite3

相关文档

  • 开发文档.md — 完整的开发规范与 API 接口设计

Introduction

使用 opencode + deepseek-v4-flash 编写的个人博客

Customize your domain