diff --git a/website/docs/read/sheet.md b/website/docs/read/sheet.md
index c48001519..ba47a2343 100644
--- a/website/docs/read/sheet.md
+++ b/website/docs/read/sheet.md
@@ -34,6 +34,8 @@ public void readAllSheet() {
 
 You can read a specific Sheet from an Excel file, supporting specification by Sheet index or name.
 
+> **Note:** Sheet names are limited to 31 characters in Excel. When reading sheets by name, use the actual sheet name that appears in the Excel file.
+
 ### Code Example
 
 ```java
diff --git a/website/docs/write/sheet.md b/website/docs/write/sheet.md
index 5e3490b28..83f3751af 100644
--- a/website/docs/write/sheet.md
+++ b/website/docs/write/sheet.md
@@ -7,6 +7,8 @@ title: 'Sheet'
 
 This chapter introduces how to configure Sheets to write data.
 
+> **Note:** Excel limits sheet names to 31 characters. Longer names are automatically trimmed with a warning logged.
+
 ## Writing to the Same Sheet
 
 ### Overview
diff --git a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/read/sheet.md b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/read/sheet.md
index b453d7e62..5971e81ca 100644
--- a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/read/sheet.md
+++ b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/read/sheet.md
@@ -34,6 +34,8 @@ public void readAllSheet() {
 
 可以读取 Excel 文件具体的某个 Sheet，支持指定 Sheet 的索引或名称
 
+> **注意：** Excel 中 Sheet 名称最多为 31 个字符。按名称读取时，请使用文件中实际显示的 Sheet 名称。
+
 ### 代码示例
 
 ```java
diff --git a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/write/sheet.md b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/write/sheet.md
index 3e3218912..bec171524 100644
--- a/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/write/sheet.md
+++ b/website/i18n/zh-cn/docusaurus-plugin-content-docs/current/write/sheet.md
@@ -7,6 +7,8 @@ title: 'Sheet 页'
 
 本章节将介绍设置 Sheet 来写入数据的使用。
 
+> **注意：** Excel 中 Sheet 名称最多为 31 个字符。超过此长度的名称将被自动截断，并记录警告日志。
+
 ## 写入同一个 Sheet
 
 ### 概述