docs: 新增优惠券和礼品卡相关文档

- 新增 Vue 模板标签错误修复总结文档
- 新增 优惠券列表页面优化说明文档
- 新增 优惠券和礼品卡弹窗优化说明文档
- 新增 商品关联功能修复说明文档

docs/重复声明错误修复说明.md

@@ -0,0 +1,250 @@
+# 重复声明错误修复说明
+
+## 🐛 问题描述
+
+在优惠券编辑组件中出现TypeScript编译错误：
+
+```
+[plugin:vite:vue] [vue/compiler-sfc] Identifier 'resetFields' has already been declared. (362:10)
+```
+
+## 🔍 问题分析
+
+### 错误原因
+在同一个作用域中，`resetFields` 标识符被声明了两次，违反了JavaScript/TypeScript的变量声明规则。
+
+### 错误位置
+```javascript
+// 第一次声明 (第653行)
+const { resetFields } = useForm(form, rules);
+
+// 第二次声明 (第735行) - ❌ 重复声明
+const { resetFields } = useForm(form, rules);
+```
+
+### 影响范围
+- TypeScript编译错误
+- 项目无法正常启动
+- 开发体验受影响
+
+## ✅ 修复方案
+
+### 1. **定位重复声明**
+
+#### 查找所有 `resetFields` 声明
+```bash
+# 搜索结果显示3个匹配项
+Found 3 matching lines:
+> 653  const { resetFields } = useForm(form, rules);  # 第一次声明
+> 735  const { resetFields } = useForm(form, rules);  # 第二次声明（重复）
+> 799  resetFields();                                 # 使用
+```
+
+### 2. **删除重复声明**
+
+#### 修复前
+```javascript
+// 第653行 - 第一次声明（保留）
+const { resetFields } = useForm(form, rules);
+
+// ... 其他代码 ...
+
+// 第735行 - 第二次声明（需要删除）
+const { resetFields } = useForm(form, rules);
+
+watch(
+  () => props.visible,
+  async (visible) => {
+    // ...
+  }
+);
+```
+
+#### 修复后
+```javascript
+// 第653行 - 第一次声明（保留）
+const { resetFields } = useForm(form, rules);
+
+// ... 其他代码 ...
+
+// 删除重复声明，直接进入watch
+watch(
+  () => props.visible,
+  async (visible) => {
+    // ...
+  }
+);
+```
+
+### 3. **验证修复效果**
+
+#### 编译成功
+```bash
+✓ ready in 1324ms
+➜  Local:   http://localhost:5174/
+```
+
+## 📚 JavaScript/TypeScript变量声明规则
+
+### 1. **变量声明原则**
+- 同一作用域内，变量名必须唯一
+- 不能重复声明同名变量
+- 使用 `const`、`let`、`var` 声明的变量都受此限制
+
+### 2. **常见重复声明场景**
+```javascript
+// ❌ 错误：重复声明
+const name = 'first';
+const name = 'second';  // Error: Identifier 'name' has already been declared
+
+// ❌ 错误：不同声明方式也不能重复
+let age = 18;
+const age = 20;  // Error: Identifier 'age' has already been declared
+
+// ✅ 正确：不同作用域可以同名
+const name = 'outer';
+{
+  const name = 'inner';  // OK: 不同作用域
+}
+```
+
+### 3. **解构赋值重复声明**
+```javascript
+// ❌ 错误：解构赋值重复声明
+const { resetFields } = useForm(form, rules);
+const { resetFields } = useForm(form, rules);  // Error
+
+// ✅ 正确：只声明一次
+const { resetFields } = useForm(form, rules);
+
+// ✅ 正确：重命名避免冲突
+const { resetFields } = useForm(form, rules);
+const { resetFields: resetFields2 } = useForm(form2, rules2);
+```
+
+## 🔧 修复过程
+
+### 步骤1：识别错误
+```bash
+[vue/compiler-sfc] Identifier 'resetFields' has already been declared.
+```
+
+### 步骤2：定位声明位置
+```javascript
+// 搜索 resetFields 找到所有声明和使用位置
+653: const { resetFields } = useForm(form, rules);  // 第一次声明
+735: const { resetFields } = useForm(form, rules);  // 重复声明
+799: resetFields();                                 // 使用
+```
+
+### 步骤3：分析代码逻辑
+- 第653行的声明是必需的，用于后续的 `resetFields()` 调用
+- 第735行的声明是多余的，可能是复制粘贴导致的错误
+
+### 步骤4：删除重复声明
+```javascript
+// 删除第735行的重复声明
+- const { resetFields } = useForm(form, rules);
+```
+
+### 步骤5：验证修复
+- 编译成功
+- 功能正常
+- 无错误提示
+
+## 📊 修复效果
+
+### 修复前
+- ❌ TypeScript编译错误
+- ❌ 项目无法启动
+- ❌ 开发阻塞
+
+### 修复后
+- ✅ 编译成功
+- ✅ 项目正常启动
+- ✅ 功能完整
+
+## 🚀 预防措施
+
+### 1. **代码审查**
+- 提交前检查重复声明
+- 使用ESLint规则检测
+- 团队代码审查机制
+
+### 2. **IDE配置**
+```json
+// .eslintrc.js
+{
+  "rules": {
+    "no-redeclare": "error",
+    "no-duplicate-imports": "error"
+  }
+}
+```
+
+### 3. **开发习惯**
+- 避免复制粘贴代码
+- 使用有意义的变量名
+- 定期重构清理代码
+
+### 4. **工具辅助**
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "noImplicitReturns": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true
+  }
+}
+```
+
+## 🔍 常见重复声明错误
+
+### 1. **函数重复声明**
+```javascript
+// ❌ 错误
+function getName() { return 'first'; }
+function getName() { return 'second'; }  // Error
+
+// ✅ 正确
+function getName() { return 'name'; }
+```
+
+### 2. **导入重复声明**
+```javascript
+// ❌ 错误
+import { useState } from 'react';
+import { useState } from 'react';  // Error
+
+// ✅ 正确
+import { useState } from 'react';
+```
+
+### 3. **类重复声明**
+```javascript
+// ❌ 错误
+class User {}
+class User {}  // Error
+
+// ✅ 正确
+class User {}
+```
+
+## 🎯 总结
+
+通过删除重复的 `resetFields` 声明，成功解决了TypeScript编译错误：
+
+### 修复要点
+1. **识别重复**：准确定位重复声明的位置
+2. **分析逻辑**：理解代码逻辑，确定哪个声明是必需的
+3. **安全删除**：删除多余的声明，保留必要的功能
+4. **验证修复**：确保修复后功能正常
+
+### 技术价值
+1. **编译成功**：消除TypeScript编译错误
+2. **代码质量**：提升代码规范性和可维护性
+3. **开发效率**：避免重复声明导致的开发阻塞
+4. **团队协作**：建立良好的代码规范和审查机制
+
+现在优惠券编辑组件已经完全修复，可以正常编译和运行！