diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index 569da4b2..eaf71c45 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -78,6 +78,7 @@ export default defineConfig({
{text: '乐观锁', link: '/zh/core/version'},
{text: '数据填充', link: '/zh/core/fill'},
{text: '数据脱敏', link: '/zh/core/mask'},
+ {text: '数据缓存', link: '/zh/core/data-cache'},
{text: 'SQL 审计', link: '/zh/core/audit'},
{text: 'SQL 打印', link: '/zh/core/sql-print'},
{text: '多数据源', link: '/zh/core/multi-datasource'},
diff --git a/docs/zh/core/data-cache.md b/docs/zh/core/data-cache.md
new file mode 100644
index 00000000..cb9edbea
--- /dev/null
+++ b/docs/zh/core/data-cache.md
@@ -0,0 +1,170 @@
+# 数据缓存
+
+MyBatis-Flex 是一个 MyBatis 增强框架,所以您可以使用 MyBatis 提供的二级缓存来作为数据缓存。但是它仍然有很多的缺点,比如不适用于分布式环境,在这里推荐使用 [Spring Cache](https://docs.spring.io/spring-framework/docs/5.2.24.RELEASE/spring-framework-reference/integration.html#cache) 模块来处理数据缓存。
+
+## 使用方法
+
+因为要用到 Spring Cache 模块,所以您的项目必须要使用 Spring Framework 框架,这里以 Spring Boot 项目作为例子,实现 MyBatis-Flex 项目将缓存数据存入 Redis 组件中。
+
+1、引入 `spring-boot-starter-cache` 和 `spring-boot-starter-data-redis`模块
+
+```xml
+
+
+ org.springframework.boot
+ spring-boot-starter-cache
+
+
+ org.springframework.boot
+ spring-boot-starter-data-redis
+
+
+```
+
+2、设置 Redis 连接信息(全是默认的话可以跳过这步)
+
+```yaml
+spring:
+ redis:
+ port: 6379
+ host: localhost
+```
+
+3、在 Spring Boot 配置类上启用 Spring Cache 缓存
+
+```java
+@EnableCaching
+@Configuration
+public class CacheConfig {
+}
+```
+
+4、将 ServiceImpl 默认实现类换为 CacheableServiceImpl 实现类
+
+```java
+public interface AccountService extends IService {
+}
+
+@Service
+public class AccountServiceImpl extends CacheableServiceImpl implements AccountService {
+}
+```
+
+5、最后即可使用 Spring Cache 的相关注解实现数据缓存到 Redis 中了
+
+```java
+// 设置统一的缓存名称
+@Service
+@CacheConfig(cacheNames = "account")
+public class AccountServiceImpl extends CacheableServiceImpl implements AccountService {
+
+ // 根据主键缓存数据
+ @Override
+ @Cacheable(key = "#id")
+ public Account getById(Serializable id) {
+ return super.getById(id);
+ }
+
+ // 根据方法名加查询 SQL 语句缓存结果数据
+ // 加上方法名是为了避免不同的方法使用一样的 QueryWrapper
+ @Override
+ @Cacheable(key = "#root.methodName + ':' + #query.toDebugSQL()")
+ public List list(QueryWrapper query) {
+ return super.list(query);
+ }
+
+}
+```
+
+## 使用说明
+
+MyBatis-Flex 在 IService 接口中做了方法调用链优化,所以您只需将缓存注解加到一些特定的方法上,即可实现所有相关的方法也可以进行数据缓存。相关方法见如下示例:
+
+```java
+@Service
+@CacheConfig(cacheNames = "account")
+public class AccountServiceImpl extends CacheableServiceImpl {
+
+ @Override
+ @CacheEvict(allEntries = true)
+ public boolean remove(QueryWrapper query) {
+ return super.remove(query);
+ }
+
+ @Override
+ @CacheEvict(key = "#id")
+ public boolean removeById(Serializable id) {
+ return super.removeById(id);
+ }
+
+ @Override
+ @CacheEvict(allEntries = true)
+ public boolean removeByIds(Collection extends Serializable> ids) {
+ return super.removeByIds(ids);
+ }
+
+ @Override
+ @CachePut(key = "#entity.id")
+ public boolean update(Account entity, QueryWrapper query) {
+ return super.update(entity, query);
+ }
+
+ @Override
+ @CachePut(key = "#entity.id")
+ public boolean updateById(Account entity) {
+ return super.updateById(entity);
+ }
+
+ @Override
+ @Cacheable(key = "#id")
+ public Account getById(Serializable id) {
+ return super.getById(id);
+ }
+
+ @Override
+ @Cacheable(key = "#root.methodName + ':' + #query.toDebugSQL()")
+ public Account getOne(QueryWrapper query) {
+ return super.getOne(query);
+ }
+
+ @Override
+ @Cacheable(key = "#root.methodName + ':' + #query.toDebugSQL()")
+ public R getOneAs(QueryWrapper query, Class asType) {
+ return super.getOneAs(query, asType);
+ }
+
+ @Override
+ @Cacheable(key = "#root.methodName + ':' + #query.toDebugSQL()")
+ public List list(QueryWrapper query) {
+ return super.list(query);
+ }
+
+ @Override
+ @Cacheable(key = "#root.methodName + ':' + #query.toDebugSQL()")
+ public List listAs(QueryWrapper query, Class asType) {
+ return super.listAs(query, asType);
+ }
+
+ // 无法通过注解进行缓存操作
+ @Override
+ @Deprecated
+ public List listByIds(Collection extends Serializable> ids) {
+ return super.listByIds(ids);
+ }
+
+ @Override
+ @Cacheable(key = "#root.methodName + ':' + #query.toDebugSQL()")
+ public long count(QueryWrapper query) {
+ return super.count(query);
+ }
+
+ @Override
+ @Cacheable(key = "#root.methodName + ':' + #query.toDebugSQL()")
+ public Page page(Page page, QueryWrapper query) {
+ return super.page(page, query);
+ }
+
+}
+```
+
+