diff --git a/packages/vant/docs/markdown/migrate-from-v3.zh-CN.md b/packages/vant/docs/markdown/migrate-from-v3.zh-CN.md
index 10971d932..6864dfaab 100644
--- a/packages/vant/docs/markdown/migrate-from-v3.zh-CN.md
+++ b/packages/vant/docs/markdown/migrate-from-v3.zh-CN.md
@@ -4,7 +4,7 @@
本文档提供了从 Vant 3 到 Vant 4 的升级指南。
-## API 调整
+## 组件重构
### Picker 组件重构
@@ -26,6 +26,14 @@
详细用法请参见 [Picker 组件文档](#/zh-CN/picker)。
+### DatetimePicker 组件重构
+
+DatetimePicker 组件被拆分为了三个组件:
+
+- TimePicker: 用于时间选择。
+- DatePicker: 用于日期选择。
+- DatetimePicker: 用于同时选择日期和时间。
+
### Area 组件重构
Area 组件是基于 Picker 组件进行封装的,因此本次升级也对 Area 组件进行了内部逻辑的重构,并优化了部分 API 设计。
@@ -42,13 +50,44 @@ Area 组件是基于 Picker 组件进行封装的,因此本次升级也对 Are
详细用法请参见 [Area 组件文档](#/zh-CN/area)。
+## API 调整
+
+### 事件命名调整
+
+从 Vant 4 开始,所有的事件均采用 Vue 官方推荐的**驼峰格式**进行命名。
+
+```js
+// Vant 3
+emit('click-input');
+
+// Vant 4
+emit('clickInput');
+```
+
+由于 Vue 会自动在模板中对事件名进行格式转换,因此这项改动不影响原有的模板代码。
+
+```html
+
+
+```
+
+此改动会影响 JSX 代码,需要将事件名调整为驼峰格式:
+
+```jsx
+// Vant 3
+
+
+// Vant 4
+
+```
+
### 其他 API 调整
4.0 版本中,以下 API 进行了不兼容更新:
#### Tabs
-- 移除了 `click` 和 `disabled` 事件,使用 `click-tab` 事件代替
+- 移除了 `click` 和 `disabled` 事件,请使用 `click-tab` 事件代替
## 样式变量调整