SpringBoot+Vue 自托管备忘录 my-memos 全面重构升级｜轻量无广告个人笔记开源项目

2026/8/4 11:47:16 拓冰建站浏览量

前言

之前给大家分享过我基于 SpringBoot + Vue 开发的开源备忘录项目my-memos，当时不少小伙伴下载、试用，还有很多朋友在评论区提出优化建议，非常感谢大家的支持！

这段时间抽空对整个项目完整重构，重写底层架构、前端交互与数据逻辑，修复历史遗留bug，新增大量实用功能，同时大幅优化部署流程与二次开发体验。
项目完整开源托管在 Gitee：

https://gitee.com/lvoyee/my-memos

一、项目定位

my-memos是一款私有化部署、无广告、轻量化个人备忘录系统，主打随手记录、Markdown笔记、标签分类、图片附件、暗黑模式。

个人用户：替代第三方云笔记，数据存放在自己服务器，隐私完全可控；
开发学习者：标准前后端分离实战项目，适合练习 SpringBoot + Vue 全栈开发；
小型团队：可搭建简易内部记事、工作台账平台。

二、技术栈（重构后优化）

后端

核心框架：SpringBoot 2.x
安全认证：JWT 无状态登录
ORM：Spring Data JPA（重构后简化数据库操作，代码结构更加整洁）
数据库：MySQL
配套工具：Maven、Lombok、统一全局异常处理、通用分页封装

前端

框架：Vue2 + Element UI
优化点：重构路由、状态管理，清理冗余组件，首屏加载速度显著提升
特性支持：Markdown实时编辑、图片拖拽粘贴上传、深色/浅色主题切换、移动端响应式适配

三、本次重构核心升级亮点

1. 底层架构重构

后端分层彻底解耦，Controller/Service/Repository职责清晰，新增统一返回体、全局拦截器；
数据库查询优化，分页、标签关联查询性能提升，大量笔记场景下不再卡顿；
重构登录鉴权逻辑，修复token过期、重复登录、权限校验等历史问题。

2. 前端交互全面翻新

全新UI布局，侧边导航、笔记卡片样式重绘，视觉体验更加清爽；
Markdown编辑器升级，支持图片粘贴上传、代码块高亮、表格/列表快捷插入；
完善暗黑模式，修复深色模式下文字、图片显示异常问题；
全局检索、标签筛选、时间归档，快速检索历史备忘录。

3. 新增实用功能

笔记附件上传：支持图片本地存储，预留自定义OSS存储配置；
笔记可见性控制：区分公开笔记 / 私有笔记；
批量操作：批量删除、批量添加标签；
首页日历视图，直观查看每日记录数量；
用户中心完善：头像修改、密码重置、自定义文件存储路径。

4. 部署&开发体验优化

简化初始化SQL脚本，导入即可使用；
完善README文档：包含本地启动步骤、服务器部署教程、全部配置项说明；
代码注释全覆盖，新手更容易读懂业务逻辑，方便二次开发；
打包流程优化，Jar包体积精简，低配服务器也能流畅运行。

四、快速上手部署

1. 克隆项目

gitclone https://gitee.com/lvoyee/my-memos.git

2. 后端启动

创建 MySQL 数据库，导入项目内 sql/init.sql；
修改 application.yml 中的数据库账号、密码；
通过 Maven 运行或打包 Jar 启动，默认端口 8080。

3. 前端启动

cdwebnpminstallnpmrun serve

正式部署执行 npm run build，将 dist 静态文件交由 Nginx 托管即可。

五、开源说明 & 求 Star/Fork

项目完全开源，宽松开源协议，个人免费使用，允许二次修改、商用改造（保留项目来源标注即可）。
如果你觉得这个项目对你有用：
1.🌟 点个 Star：是对我持续维护更新最大的鼓励，也能让更多开发者发现这个项目；
2.🍴 Fork 项目：拉取副本自由二次开发，按需拓展自定义功能；
3.💬 Bug 反馈、新功能需求直接提交 Issues，我会定期迭代修复；
4.🤝 欢迎提交 PR 共同完善项目，一起优化这个全栈备忘录 Demo。

六、写在最后

最初开发 my-memos 一方面用来练习前后端分离技术，另一方面给自己搭建私有记事本。上次分享之后收到很多小伙伴的反馈，本次投入大量时间重构，解决了之前大家反馈的卡顿、缺陷、功能单一等问题。

期待大家的 Star、Fork！任何使用问题、开发疑问都可以在 Gitee 仓库评论区留言，我会尽量回复。

The end.

建站实战干货