diff --git a/docs/api/storage.md b/docs/api/storage.md
index 90e3880d7d82e75e1230e6b358b2adf17dc746ec..4cde6e0d2b7fa6d714f2d72cf82b19a6f147d940 100644
--- a/docs/api/storage.md
+++ b/docs/api/storage.md
@@ -57,6 +57,8 @@ uni-app的Storage在不同端的实现不同：
 
 <!-- UTSAPIJSON.getStorage.tutorial -->
 
+> 注意：获取一个不存在的 key 会触发 fail 回调，返回错误信息为 "getStorage:fail data not found" 的错误。
+
 ## uni.getStorageSync(key) @getstoragesync
 
 <!-- UTSAPIJSON.getStorageSync.description -->
@@ -71,6 +73,8 @@ uni-app的Storage在不同端的实现不同：
 
 <!-- UTSAPIJSON.getStorageSync.tutorial -->
 
+> 注意：同步方法获取一个不存在的 key 会返回空字符串，而不是 null
+
 ## uni.getStorageInfo(options) @getstorageinfo
 
 <!-- UTSAPIJSON.getStorageInfo.description -->