diff --git a/docs/component/canvas.md b/docs/component/canvas.md
index e06ce70839dda401e1dfa9978424281111c50478..4019b96311fdfea62a164e694e44ecfd8713d8b0 100644
--- a/docs/component/canvas.md
+++ b/docs/component/canvas.md
@@ -22,15 +22,17 @@
 
 ## 注意事项@hidpi
 
-老版本 canvas 使用了微信小程序的的旧版规范，和 W3C 规范有差异
+老版 uni-app 的 canvas 使用了微信小程序的的旧版规范，和 W3C 规范有差异。微信小程序新版的 canvas 规范已经与 W3C 规范拉齐。
 
-uni-app x 废弃了老版方案，使用了 W3C 规范和微信小程序的新版规范
+uni-app x 中废弃了老版方案，使用了 W3C 规范和微信小程序的新版规范。
 
-新版规范需要开发者根据自己的场景手动处理高清屏问题
+注意：在uni-app x 4.21版以前，开发者写的老版canvas是可以运行的。但从 4.21+ 支持新版规范起，不再支持老版规范。开发者需调整代码。
+
+注意：新版规范需要开发者根据自己的场景手动处理高清屏问题。
 
 ```html
-<template>
-  <canvas id="canvas"></canvas>
+<template>
+  <canvas id="canvas"></canvas>
 </template>
 <script setup>
 // 获取 canvas element