From 73b881c096d3afcd8b1a9a0108db02da31689255 Mon Sep 17 00:00:00 2001
From: LCJ-MinYa <1049468118@qq.com>
Date: Fri, 6 Feb 2026 17:01:30 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20js=E5=BC=82=E6=AD=A5=E7=BC=96=E7=A8=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 GEMINI.md                                   |   2 +
 src/router/modules/demo.ts                  |   4 +
 src/views/demo/jsAsyncAwait/index.vue       |  18 +++
 src/views/demo/jsAsyncAwait/jsAsyncAwait.md | 152 ++++++++++++++++++++
 src/views/tool/jsCoreNav.vue                |   5 +
 5 files changed, 181 insertions(+)
 create mode 100644 src/views/demo/jsAsyncAwait/index.vue
 create mode 100644 src/views/demo/jsAsyncAwait/jsAsyncAwait.md

diff --git a/GEMINI.md b/GEMINI.md
index 5760ec3..452bda4 100644
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -52,6 +52,8 @@ vue3-mgt-template/
 4.  **文档记录**：
     - 结束会话前，**必须**将本次核心变动以“本次会话总结”格式更新到 `README.md` 的“对话记录”部分。
     - 尽可能为新代码添加详细的中文文档和注释。
+5.  **错误纠正**:
+    - 每次被用户纠正错误后**必须**在GEMINI.md添加新规则避免重复错误。
 
 ### 代码风格
 - **TypeScript**: 严格模式，避免 `any`。
diff --git a/src/router/modules/demo.ts b/src/router/modules/demo.ts
index eefa6e4..0504d4c 100644
--- a/src/router/modules/demo.ts
+++ b/src/router/modules/demo.ts
@@ -202,6 +202,10 @@ const titleArr = [
         key: 'jsHoistingScope',
         title: 'js中变量提升与作用域',
     },
+    {
+        key: 'jsAsyncAwait',
+        title: 'js异步编程AsyncAwait',
+    },
 ];
 
 // @/views/demo/**/*.vue
diff --git a/src/views/demo/jsAsyncAwait/index.vue b/src/views/demo/jsAsyncAwait/index.vue
new file mode 100644
index 0000000..2b02dd6
--- /dev/null
+++ b/src/views/demo/jsAsyncAwait/index.vue
@@ -0,0 +1,18 @@
+<template>
+    <div
+        class="markdown-body"
+        v-html="htmlStr"
+    />
+</template>
+
+<script setup>
+import { ref } from 'vue';
+import { marked } from 'marked';
+import { getMarkdownContent } from '@/utils/tools';
+
+const htmlStr = ref('');
+
+getMarkdownContent('./md/jsAsyncAwait.md').then((res) => {
+    htmlStr.value = marked(res);
+});
+</script>
diff --git a/src/views/demo/jsAsyncAwait/jsAsyncAwait.md b/src/views/demo/jsAsyncAwait/jsAsyncAwait.md
new file mode 100644
index 0000000..5a69004
--- /dev/null
+++ b/src/views/demo/jsAsyncAwait/jsAsyncAwait.md
@@ -0,0 +1,152 @@
+# 异步编程AsyncAwait
+
+```javascript
+async function async1() {
+  console.log('async1 start');
+  await async2();
+  console.log('async1 end');
+}
+
+async function async2() {
+  console.log('async2');
+}
+
+console.log('script start');
+
+setTimeout(() => {
+  console.log('setTimeout');
+}, 0);
+
+async1();
+
+new Promise(function(resolve) {
+  console.log('promise1');
+  resolve();
+}).then(function() {
+  console.log('promise2');
+});
+
+console.log('script end');
+```
+
+**实际输出**：
+```
+script start
+async1 start
+async2
+promise1
+script end
+async1 end
+promise2
+setTimeout
+```
+
+---
+
+### 📚 **详细解析**
+
+#### **关键点理解**
+`await` 后面的代码相当于被包装在 `Promise.then()` 中，是**微任务**
+
+#### **执行步骤分解**：
+
+**1. 同步代码执行**：
+```javascript
+console.log('script start');                    // 1. script start
+console.log('async1 start');                    // 2. async1 start (在async1中)
+console.log('async2');                          // 3. async2 (在async2中)
+console.log('promise1');                        // 4. promise1 (在Promise构造函数中)
+console.log('script end');                      // 5. script end
+```
+
+**2. 微任务队列状态**：
+- `await async2()` 后的代码被放入微任务队列：`console.log('async1 end')`
+- `Promise.resolve().then(...)` 被放入微任务队列：`console.log('promise2')`
+
+**3. 事件循环顺序**：
+```javascript
+// 执行所有微任务（按入队顺序）
+console.log('async1 end');                      // 6. async1 end
+console.log('promise2');                        // 7. promise2
+
+// 执行宏任务
+console.log('setTimeout');                      // 8. setTimeout
+```
+
+### 🎯 **重要规则**
+1. **async函数中，`await` 之前的代码是同步执行的**
+2. **`await` 后面的代码会被包装成微任务**
+3. **Promise构造函数中的代码是同步执行的**
+4. **`.then()` 中的回调是微任务**
+
+### 💡 **记忆技巧**
+```
+async函数执行流程：
+1. 执行await之前的代码（同步）
+2. 执行await表达式（同步）
+3. 将await后面的代码包装成微任务
+4. 函数暂停，返回Promise
+5. 继续执行函数外部的同步代码
+6. 执行微任务（包括await后面的代码）
+```
+
+---
+## **变形题（巩固async/await）**
+```javascript
+async function async1() {
+  console.log('async1 start');
+  await async2();
+  console.log('async1 end');
+  await async3();
+  console.log('async1 end1');  
+}
+
+async function async2() {
+  console.log('async2');
+}
+
+async function async3() {
+  console.log('async3');
+}
+
+console.log('script start');
+
+setTimeout(() => {
+  console.log('setTimeout');
+}, 0);
+
+async1();
+
+new Promise(function(resolve) {
+  console.log('promise1');
+  resolve();
+}).then(function() {
+  console.log('promise2');
+});
+
+console.log('script end');
+```
+
+## **变形题（巩固async/await）**
+
+```javascript
+console.log('1');
+
+setTimeout(() => console.log('2'), 0);
+
+Promise.resolve().then(() => console.log('3'));
+
+async function asyncFunc() {
+  console.log('4');
+  await Promise.resolve();
+  console.log('5');
+}
+
+asyncFunc();
+
+Promise.resolve().then(() => console.log('6'));
+
+console.log('7');
+```
+
+**问题：请写出完整的输出顺序。**
\ No newline at end of file
diff --git a/src/views/tool/jsCoreNav.vue b/src/views/tool/jsCoreNav.vue
index cac7054..9b9953f 100644
--- a/src/views/tool/jsCoreNav.vue
+++ b/src/views/tool/jsCoreNav.vue
@@ -137,6 +137,11 @@ const navList = ref<NavItem[]>([
         path: '/demo/jsEventLoop',
         desc: '宏任务与微任务的交替执行，浏览器渲染帧的调度机制。',
     },
+    {
+        title: '异步编程AsyncAwait',
+        path: '/demo/jsAsyncAwait',
+        desc: 'async/await 是基于 Promise 的语法糖，用同步的写法处理异步操作，使代码更简洁易读。',
+    },
 ]);
 
 const filteredList = computed(() => {