一个项目搞定：同域、跨域、共享Redis、跨Redis、前后端一体、前后端分离、纯 js、vue2、vue3、非 Sa-Token 项目、非 java 项目等架构下的 SSO 认证需求。

一次购买，永久授权。全源码交付，不含密 Jar。提供售后技术支持。

源码运行指南

如果你想阅读或调试 Sa-Token 源码，可按以下步骤在本地运行框架及 Demo 示例。

方式一：Git 克隆（推荐）

Sa-Token 源码目前在 Gitee、GitHub、AtomGit 三个平台进行托管，你可以从任意其一进行克隆下载源码。

学习测试建议拉取 master 分支；dev 为开发分支，代码随时变动，有时候会运行不起来。（如果你要提交 pr，则需要拉取 dev 分支）

shell

git clone -b master https://gitee.com/dromara/sa-token.git

方式二：官网 / 仓库页下载压缩包

在 Gitee、GitHub、AtomGit 三者任意一个平台，使用「克隆 / 下载」下载源码压缩包，解压后即可使用。

打开 IDEA，选择 Open，选中源码根目录，进行打开。

Sa-Token 并非一个完整可运行的传统项目，而是一个需要被引入的框架。因此不存在传统意义下的运行源码，你可以运行的是其中各项 demo 示例。

打开 sa-token-demo 目录，选择你想要运行的示例添加为 Maven 项目，打开 XxxApplication.java 运行。

注意：首次在 IDEA 中运行项目时，可能会触发报错：

java: 程序包cn.dev33.satoken.apikey不存在

这是因为在 Sa-Token 中，sa-token-apikey、sso、oauth2、sign、jwt 等模块均为可选包，IDEA 有时候会跳过相关模块的编译，然后运行时又找不到这些包，触发报错。

解决方案是先运行一下 sa-token-demo-first-run 这个 demo，该项目强制引入了这些模块，会引导 IDEA 对相关模块进行编译。

如果此项目仍然无法运行成功，请根据控制台的报错提示，把相关模块加入到此项目的 pom.xml 中，然后点击右上角 maven 刷新依赖图标，然后再次点击运行。

如果还不行，那就在项目根目录进入 cmd，执行 mvn package，然后重新运行试试。

如果还是不行，那就加群反馈一下，我们再根据你的情况寻找一下新方案。

根目录双击执行 preview-doc.bat 可在本地预览 sa-token-doc 文档。

源码运行指南 ​