diff --git a/.gitee/ISSUE_TEMPLATE/bug.yml b/.gitee/ISSUE_TEMPLATE/bug.yml
index e31ab2d7..8c9f341b 100644
--- a/.gitee/ISSUE_TEMPLATE/bug.yml
+++ b/.gitee/ISSUE_TEMPLATE/bug.yml
@@ -7,7 +7,7 @@ body:
         attributes:
             label: 这个 Bug 是否已经存在：
             options:
-                -   label: 我确定已经把 MyBatis-Flex 升级到最新版本 v1.8.7，并已搜索过现有的问题 (https://gitee.com/mybatis-flex/mybatis-flex/issues)
+                -   label: 我确定已经把 MyBatis-Flex 升级到最新版本 v1.8.8，并已搜索过现有的问题 (https://gitee.com/mybatis-flex/mybatis-flex/issues)
                     required: true
     -   type: textarea
         attributes:
diff --git a/changes.md b/changes.md
index 6605d039..4545453b 100644
--- a/changes.md
+++ b/changes.md
@@ -3,8 +3,25 @@
 查看 [全部代码贡献者](/zh/intro/what-is-mybatisflex.html#贡献者)。
 
 
+## v1.8.8 20240418
+- 新增：新增支持全局注册多个监听器的功能，感谢 @Suomm
+- 修复：TableInfo 的 comment 构建错误的问题
+- 修复：由 case 构建查询条件参数丢失问题，感谢 @Suomm
+- 修复：TableRef 解析 VO 之后覆盖 tableInfoMap 缓存中原有 Entity 的问题，感谢 @Suomm
+- 修复：重名字段查找不全问题，感谢 @Suomm #I9FW4O
+- 优化：消除 Joiner 的 idea IDEA 警告，感谢 @Suomm
+- 优化：TableInfo 提供实体类与数据库字段字段映射内容，感谢 @gswy
+- 优化：调整关联查询相关功能模块访问级别，感谢 @ruansheng
+- 优化：代码生成器移除模板中多余的前导空格，感谢 @cida
+- 优化：代码生成器将 buildAnnotations 方法中，与模板统一格式，感谢 @cida
+- 优化：代码生成器将 GeneratorFactory.generators 的类型替换为 LinkedHashMap，感谢 @cida
+- 优化：在 Entity 无法初始化时给出异常原因，感谢 @Suomm #I9HL0K
+- 文档：添加 VO 类重名映射说明，感谢 @Suomm
+
+
+
 ## v1.8.7 20240410
-- 新增：feat: 添加 `@TableRef` 注解标记 VO 类和 Entity 绑定，方便关联查询直接转换为 VO，感谢 @Suomm
+- 新增：添加 `@TableRef` 注解标记 VO 类和 Entity 绑定，方便关联查询直接转换为 VO，感谢 @Suomm
 - 新增：Db + Row 支持 QueryWrapper 的原生 SQL 构建，感谢 @Suomm
 - 优化：XML 分页 #{qwSql} 参数补充逻辑删除等参数，感谢 @Suomm
 - 优化：`insertBatch(entities, size)` 和 `insertBatch(entities)` 对空 list 的处理不一致问题 #I9EGWA
diff --git a/docs/zh/changes.md b/docs/zh/changes.md
index 6605d039..4545453b 100644
--- a/docs/zh/changes.md
+++ b/docs/zh/changes.md
@@ -3,8 +3,25 @@
 查看 [全部代码贡献者](/zh/intro/what-is-mybatisflex.html#贡献者)。
 
 
+## v1.8.8 20240418
+- 新增：新增支持全局注册多个监听器的功能，感谢 @Suomm
+- 修复：TableInfo 的 comment 构建错误的问题
+- 修复：由 case 构建查询条件参数丢失问题，感谢 @Suomm
+- 修复：TableRef 解析 VO 之后覆盖 tableInfoMap 缓存中原有 Entity 的问题，感谢 @Suomm
+- 修复：重名字段查找不全问题，感谢 @Suomm #I9FW4O
+- 优化：消除 Joiner 的 idea IDEA 警告，感谢 @Suomm
+- 优化：TableInfo 提供实体类与数据库字段字段映射内容，感谢 @gswy
+- 优化：调整关联查询相关功能模块访问级别，感谢 @ruansheng
+- 优化：代码生成器移除模板中多余的前导空格，感谢 @cida
+- 优化：代码生成器将 buildAnnotations 方法中，与模板统一格式，感谢 @cida
+- 优化：代码生成器将 GeneratorFactory.generators 的类型替换为 LinkedHashMap，感谢 @cida
+- 优化：在 Entity 无法初始化时给出异常原因，感谢 @Suomm #I9HL0K
+- 文档：添加 VO 类重名映射说明，感谢 @Suomm
+
+
+
 ## v1.8.7 20240410
-- 新增：feat: 添加 `@TableRef` 注解标记 VO 类和 Entity 绑定，方便关联查询直接转换为 VO，感谢 @Suomm
+- 新增：添加 `@TableRef` 注解标记 VO 类和 Entity 绑定，方便关联查询直接转换为 VO，感谢 @Suomm
 - 新增：Db + Row 支持 QueryWrapper 的原生 SQL 构建，感谢 @Suomm
 - 优化：XML 分页 #{qwSql} 参数补充逻辑删除等参数，感谢 @Suomm
 - 优化：`insertBatch(entities, size)` 和 `insertBatch(entities)` 对空 list 的处理不一致问题 #I9EGWA
diff --git a/docs/zh/intro/getting-started.md b/docs/zh/intro/getting-started.md
index 30e72c28..ba311db2 100644
--- a/docs/zh/intro/getting-started.md
+++ b/docs/zh/intro/getting-started.md
@@ -53,7 +53,7 @@ VALUES (1, '张三', 18, '2020-01-11'),
     <dependency>
         <groupId>com.mybatis-flex</groupId>
         <artifactId>mybatis-flex-spring-boot-starter</artifactId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </dependency>
     <dependency>
         <groupId>com.mysql</groupId>
@@ -81,7 +81,7 @@ VALUES (1, '张三', 18, '2020-01-11'),
     <dependency>
         <groupId>com.mybatis-flex</groupId>
         <artifactId>mybatis-flex-spring-boot3-starter</artifactId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </dependency>
     <dependency>
         <groupId>com.mysql</groupId>
diff --git a/docs/zh/intro/gradle.md b/docs/zh/intro/gradle.md
index 62ae7283..2a405b84 100644
--- a/docs/zh/intro/gradle.md
+++ b/docs/zh/intro/gradle.md
@@ -10,7 +10,7 @@
 
 ```kotlin
 dependencies {
-    implementation("com.mybatis-flex:mybatis-flex-core:1.8.7")
+    implementation("com.mybatis-flex:mybatis-flex-core:1.8.8")
 }
 ```
 
@@ -18,7 +18,7 @@ dependencies {
 
 ```groovy
 dependencies {
-    implementation 'com.mybatis-flex:mybatis-flex-core:1.8.7'
+    implementation 'com.mybatis-flex:mybatis-flex-core:1.8.8'
 }
 ```
 
@@ -28,7 +28,7 @@ dependencies {
 
 ```kotlin
 dependencies {
-    implementation("com.mybatis-flex:mybatis-flex-spring:1.8.7")
+    implementation("com.mybatis-flex:mybatis-flex-spring:1.8.8")
 }
 ```
 
@@ -36,7 +36,7 @@ dependencies {
 
 ```groovy
 dependencies {
-    implementation 'com.mybatis-flex:mybatis-flex-spring:1.8.7'
+    implementation 'com.mybatis-flex:mybatis-flex-spring:1.8.8'
 }
 ```
 
@@ -46,7 +46,7 @@ dependencies {
 
 ```kotlin
 dependencies {
-    implementation("com.mybatis-flex:mybatis-flex-spring-boot-starter:1.8.7")
+    implementation("com.mybatis-flex:mybatis-flex-spring-boot-starter:1.8.8")
 }
 ```
 
@@ -54,7 +54,7 @@ dependencies {
 
 ```groovy
 dependencies {
-    implementation 'com.mybatis-flex:mybatis-flex-spring-boot-starter:1.8.7'
+    implementation 'com.mybatis-flex:mybatis-flex-spring-boot-starter:1.8.8'
 }
 ```
 
@@ -70,7 +70,7 @@ dependencies {
 
 ```kotlin
 dependencies {
-    annotationProcessor("com.mybatis-flex:mybatis-flex-processor:1.8.7")
+    annotationProcessor("com.mybatis-flex:mybatis-flex-processor:1.8.8")
 }
 ```
 
@@ -78,6 +78,6 @@ dependencies {
 
 ```groovy
 dependencies {
-    annotationProcessor 'com.mybatis-flex:mybatis-flex-processor:1.8.7'
+    annotationProcessor 'com.mybatis-flex:mybatis-flex-processor:1.8.8'
 }
 ```
diff --git a/docs/zh/intro/maven.md b/docs/zh/intro/maven.md
index f0cffb24..10a6190d 100644
--- a/docs/zh/intro/maven.md
+++ b/docs/zh/intro/maven.md
@@ -12,12 +12,12 @@
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-core</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
 </dependency>
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-processor</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
     <scope>provided</scope>
 </dependency>
 ```
@@ -28,12 +28,12 @@
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-spring</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
 </dependency>
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-processor</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
     <scope>provided</scope>
 </dependency>
 ``````
@@ -44,12 +44,12 @@
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-spring-boot-starter</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
 </dependency>
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-processor</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
     <scope>provided</scope>
 </dependency>
 ```
@@ -60,12 +60,12 @@
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-spring-boot3-starter</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
 </dependency>
 <dependency>
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-processor</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
     <scope>provided</scope>
 </dependency>
 ```
@@ -88,7 +88,7 @@
             <path>
                 <groupId>com.mybatis-flex</groupId>
                 <artifactId>mybatis-flex-processor</artifactId>
-                <version>1.8.7</version>
+                <version>1.8.8</version>
             </path>
         </annotationProcessorPaths>
     </configuration>
diff --git a/docs/zh/others/apt.md b/docs/zh/others/apt.md
index b24b17ec..8bb086cb 100644
--- a/docs/zh/others/apt.md
+++ b/docs/zh/others/apt.md
@@ -220,7 +220,7 @@ pom.xml 添加 `annotationProcessorPaths` 配置，
 ```
 dependencies {
     ...
-    annotationProcessor 'com.mybatis-flex:mybatis-flex-processor:1.8.7'
+    annotationProcessor 'com.mybatis-flex:mybatis-flex-processor:1.8.8'
 }
 ```
 
diff --git a/mybatis-flex-annotation/pom.xml b/mybatis-flex-annotation/pom.xml
index 1741ee73..37304f36 100644
--- a/mybatis-flex-annotation/pom.xml
+++ b/mybatis-flex-annotation/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>parent</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/mybatis-flex-codegen/pom.xml b/mybatis-flex-codegen/pom.xml
index e71aed1c..895aab27 100644
--- a/mybatis-flex-codegen/pom.xml
+++ b/mybatis-flex-codegen/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>parent</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -23,7 +23,7 @@
         <dependency>
             <groupId>com.mybatis-flex</groupId>
             <artifactId>mybatis-flex-core</artifactId>
-            <version>1.8.7</version>
+            <version>1.8.8</version>
             <exclusions>
                 <exclusion>
                     <groupId>com.mybatis-flex</groupId>
diff --git a/mybatis-flex-core/pom.xml b/mybatis-flex-core/pom.xml
index 2d03c1f7..5a6d66be 100644
--- a/mybatis-flex-core/pom.xml
+++ b/mybatis-flex-core/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>parent</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -101,7 +101,7 @@
         <dependency>
             <groupId>com.mybatis-flex</groupId>
             <artifactId>mybatis-flex-annotation</artifactId>
-            <version>1.8.7</version>
+            <version>1.8.8</version>
             <scope>compile</scope>
         </dependency>
 
diff --git a/mybatis-flex-core/src/main/java/com/mybatisflex/core/FlexConsts.java b/mybatis-flex-core/src/main/java/com/mybatisflex/core/FlexConsts.java
index 8d6168b3..161fca7c 100644
--- a/mybatis-flex-core/src/main/java/com/mybatisflex/core/FlexConsts.java
+++ b/mybatis-flex-core/src/main/java/com/mybatisflex/core/FlexConsts.java
@@ -27,7 +27,7 @@ public class FlexConsts {
     }
 
     public static final String NAME = "MyBatis-Flex";
-    public static final String VERSION = "1.8.7";
+    public static final String VERSION = "1.8.8";
 
 
     public static final String SQL = "$$sql";
diff --git a/mybatis-flex-dependencies/pom.xml b/mybatis-flex-dependencies/pom.xml
index d9eb9eb2..b15ff1cc 100644
--- a/mybatis-flex-dependencies/pom.xml
+++ b/mybatis-flex-dependencies/pom.xml
@@ -6,7 +6,7 @@
 
     <groupId>com.mybatis-flex</groupId>
     <artifactId>mybatis-flex-dependencies</artifactId>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
 
     <packaging>pom</packaging>
 
@@ -48,7 +48,7 @@
         </developer>
     </developers>
     <properties>
-        <mybatis-flex.version>1.8.7</mybatis-flex.version>
+        <mybatis-flex.version>1.8.8</mybatis-flex.version>
     </properties>
 
     <dependencyManagement>
diff --git a/mybatis-flex-processor/pom.xml b/mybatis-flex-processor/pom.xml
index c0092012..95973b51 100644
--- a/mybatis-flex-processor/pom.xml
+++ b/mybatis-flex-processor/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>parent</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -22,7 +22,7 @@
         <dependency>
             <groupId>com.mybatis-flex</groupId>
             <artifactId>mybatis-flex-annotation</artifactId>
-            <version>1.8.7</version>
+            <version>1.8.8</version>
         </dependency>
     </dependencies>
 
diff --git a/mybatis-flex-solon-plugin/pom.xml b/mybatis-flex-solon-plugin/pom.xml
index 7ac3879c..eb2a684b 100644
--- a/mybatis-flex-solon-plugin/pom.xml
+++ b/mybatis-flex-solon-plugin/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>parent</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/mybatis-flex-spring-boot-starter/pom.xml b/mybatis-flex-spring-boot-starter/pom.xml
index 26d64bf0..2844a7f0 100644
--- a/mybatis-flex-spring-boot-starter/pom.xml
+++ b/mybatis-flex-spring-boot-starter/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>parent</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -23,7 +23,7 @@
         <dependency>
             <groupId>com.mybatis-flex</groupId>
             <artifactId>mybatis-flex-spring</artifactId>
-            <version>1.8.7</version>
+            <version>1.8.8</version>
         </dependency>
 
         <dependency>
@@ -104,7 +104,7 @@
         <dependency>
             <groupId>com.mybatis-flex</groupId>
             <artifactId>mybatis-flex-core</artifactId>
-            <version>1.8.7</version>
+            <version>1.8.8</version>
         </dependency>
 
     </dependencies>
diff --git a/mybatis-flex-spring-boot3-starter/pom.xml b/mybatis-flex-spring-boot3-starter/pom.xml
index b71b832b..f40aece4 100644
--- a/mybatis-flex-spring-boot3-starter/pom.xml
+++ b/mybatis-flex-spring-boot3-starter/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.mybatis-flex</groupId>
         <artifactId>parent</artifactId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
 
     <artifactId>mybatis-flex-spring-boot3-starter</artifactId>
@@ -19,7 +19,7 @@
         <dependency>
             <groupId>com.mybatis-flex</groupId>
             <artifactId>mybatis-flex-spring-boot-starter</artifactId>
-            <version>1.8.7</version>
+            <version>1.8.8</version>
             <exclusions>
                 <exclusion>
                     <groupId>org.mybatis</groupId>
diff --git a/mybatis-flex-spring/pom.xml b/mybatis-flex-spring/pom.xml
index 104b9b5a..828df180 100644
--- a/mybatis-flex-spring/pom.xml
+++ b/mybatis-flex-spring/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>parent</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -22,7 +22,7 @@
         <dependency>
             <groupId>com.mybatis-flex</groupId>
             <artifactId>mybatis-flex-core</artifactId>
-            <version>1.8.7</version>
+            <version>1.8.8</version>
         </dependency>
 
         <dependency>
diff --git a/mybatis-flex-test/mybatis-flex-native-test/pom.xml b/mybatis-flex-test/mybatis-flex-native-test/pom.xml
index b3599780..0a8d487b 100644
--- a/mybatis-flex-test/mybatis-flex-native-test/pom.xml
+++ b/mybatis-flex-test/mybatis-flex-native-test/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>mybatis-flex-test</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/mybatis-flex-test/mybatis-flex-seata-test/pom.xml b/mybatis-flex-test/mybatis-flex-seata-test/pom.xml
index d20abfbf..f8f64ced 100644
--- a/mybatis-flex-test/mybatis-flex-seata-test/pom.xml
+++ b/mybatis-flex-test/mybatis-flex-seata-test/pom.xml
@@ -4,7 +4,7 @@
 	<parent>
 		<artifactId>mybatis-flex-test</artifactId>
 		<groupId>com.mybatis-flex</groupId>
-		<version>1.8.7</version>
+		<version>1.8.8</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 
diff --git a/mybatis-flex-test/mybatis-flex-spring-boot-test/pom.xml b/mybatis-flex-test/mybatis-flex-spring-boot-test/pom.xml
index 0576fc54..fbfc715d 100644
--- a/mybatis-flex-test/mybatis-flex-spring-boot-test/pom.xml
+++ b/mybatis-flex-test/mybatis-flex-spring-boot-test/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>mybatis-flex-test</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/mybatis-flex-test/mybatis-flex-spring-cloud-test/pom.xml b/mybatis-flex-test/mybatis-flex-spring-cloud-test/pom.xml
index 60f3088a..1ec0097c 100644
--- a/mybatis-flex-test/mybatis-flex-spring-cloud-test/pom.xml
+++ b/mybatis-flex-test/mybatis-flex-spring-cloud-test/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>mybatis-flex-test</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/mybatis-flex-test/mybatis-flex-spring-test/pom.xml b/mybatis-flex-test/mybatis-flex-spring-test/pom.xml
index a8239763..2dcca376 100644
--- a/mybatis-flex-test/mybatis-flex-spring-test/pom.xml
+++ b/mybatis-flex-test/mybatis-flex-spring-test/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>mybatis-flex-test</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/mybatis-flex-test/pom.xml b/mybatis-flex-test/pom.xml
index 128d6cb8..20917b9a 100644
--- a/mybatis-flex-test/pom.xml
+++ b/mybatis-flex-test/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>parent</artifactId>
         <groupId>com.mybatis-flex</groupId>
-        <version>1.8.7</version>
+        <version>1.8.8</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/pom.xml b/pom.xml
index a64f54f7..dbf25c0a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -7,7 +7,7 @@
     <groupId>com.mybatis-flex</groupId>
     <artifactId>parent</artifactId>
     <packaging>pom</packaging>
-    <version>1.8.7</version>
+    <version>1.8.8</version>
 
     <name>mybatis-flex</name>
     <url>https://mybatis-flex.com</url>
@@ -55,7 +55,7 @@
         <maven.compiler.source>8</maven.compiler.source>
         <maven.compiler.target>8</maven.compiler.target>
 
-        <mybatis-flex.version>1.8.7</mybatis-flex.version>
+        <mybatis-flex.version>1.8.8</mybatis-flex.version>
 
         <mybatis.version>3.5.15</mybatis.version>
         <mybatis-spring.version>2.1.2</mybatis-spring.version>