Skip to content

序言

TIP

Sz-Admin 采用 Apache License Version 2.0 开源协议,商业用途完全免费!

当前版本:v2.0.0


👉 使用本项目前,请务必阅读并遵守 《🚨 版权声明与使用说明》,以保障您的合法使用与作者权益。

如果你觉得本项目对你有帮助,欢迎 Star ⭐ | Fork ⑂ | Watch 👀 支持作者,一键三连助力开源!🚀

Sz-Admin 是一套面向企业中后台、管理端系统和二次开发项目的开源脚手架。它希望在常见后台能力、工程结构、权限体系、代码生成、数据库迁移和前后端协作之间取得一个更清晰的平衡:足够轻量,便于理解;足够完整,能够支撑真实项目;足够开放,方便你在自己的业务中继续扩展。

版本号遵循 语义化版本规范。如果你正在从旧版本升级,建议先阅读对应版本的更新日志和升级指南,再决定迁移步骤。

开源协议

在遵守 Apache License 2.0 和保留必要版权信息的前提下,你可以免费用于学习、二次开发和商业项目。

需要注意的是,源码开源协议和项目品牌资产是两个不同概念。Sz-Admin 的名称、Logo、横版品牌图、favicon 等品牌标识不随 Apache License 2.0 自动授权。公开发布二次开发版本、商业产品或 SaaS 服务前,请务必阅读并遵守 《版权声明与使用说明》

技术主线

v2.0.0 主线基于 Spring Boot 4.x、JDK 21、Vue 3 和 Element Plus。历史版本曾支持 Spring Boot 3.x,相关历史并没有被否定;只是从当前主线开始,框架会围绕新的 Java、Spring 与前端生态继续演进。

JDK 版本会持续跟进 LTS 节奏。当前选择 JDK 21,是因为它在生态适配、构建工具和生产运行方面更成熟;后续 JDK 25 也会纳入支持计划,但会等待一段稳定观察期后再推进。

使用前建议

如果你是第一次接触 Sz-Admin,建议先按下面的顺序阅读:

  1. 介绍:了解项目定位、适用场景和核心能力。
  2. 技术栈:了解当前主线依赖版本和技术选择。
  3. 快速开始:在本地跑通后端、前端和基础功能。
  4. 阅读路线:根据你的目标继续阅读权限、字典、数据权限、部署或升级文档。

如果你准备将项目用于生产或商业场景,请先确认版权声明、部署方式、数据库迁移、文件存储、备份恢复和安全配置。框架可以节省大量基础工作,但生产环境仍需要结合你的业务、服务器、网络和运维策略进行审慎配置。

反馈与支持

Sz-Admin 是在长期使用、观察和打磨后台系统的过程中逐步形成的项目。它会尽量保持结构清晰、能力实用和升级可控,但仍可能存在不足、边界问题或文档遗漏。

如果你在使用中发现问题,欢迎通过仓库 Issue、讨论群或文档中提供的联系方式反馈。清晰的问题描述、复现步骤、版本信息和相关日志,都会帮助项目更快定位和改进。

如果这个项目对你有帮助,也欢迎通过 Star、Fork、分享使用经验、提交 PR 或补充文档来支持它。每一次反馈和改进,都会让这个项目更接近真实用户需要的样子。