n8n-guide/docs/learning/templates.md

# 模板套用

## 📚 模板资源库

!!! tip "精选模板资源"
    - **GitHub最全集合**: [Awesome n8n Templates (2000+)](https://github.com/enescingoz/awesome-n8n-templates) ✅
    - **分类工作流集合**: [n8n Workflows Collection (2000+)](https://github.com/Zie619/n8n-workflows) ✅  
    - **官方精选模板**: [n8n.io/workflows (500+)](https://n8n.io/workflows)
    - **实用案例合集**: 覆盖各行业常见自动化场景

---

n8n的模板套用方式非常直观，通过复制粘贴就能快速应用成熟的工作流方案。

## 🚀 快速模板应用

### 使用方法

1. **复制模板代码**：在任意位置复制整段JSON文本

![复制模板代码](../assets/images/复制.png)

2. **粘贴到n8n**：在n8n画布任意位置粘贴

![粘贴到n8n](../assets/images/黏贴.png)

3. **配置参数**：根据需要调整节点参数
4. **测试运行**：验证工作流是否正常

**复制模板** → **粘贴到n8n** → **配置凭证** → **调整参数** → **测试运行** → **部署上线**

## 📚 模板资源库

### 模板分类浏览

**按业务场景分类：**
- **营销自动化** - 邮件营销、社交媒体管理、客户关系维护
- **数据处理** - 数据同步、清洗、转换、分析  
- **办公自动化** - 文档处理、会议安排、任务管理
- **电商运营** - 订单处理、库存管理、客服自动回复
- **内容管理** - 文章发布、图片处理、SEO优化

### 分类模板推荐

=== "数据处理"
    - **Excel数据清洗**: 自动化数据验证和格式化
    - **CSV文件合并**: 多文件数据整合
    - **数据库同步**: 不同系统间数据同步
    - **报表生成**: 定期业务报表自动生成

=== "通信自动化"
    - **邮件营销**: 个性化邮件批量发送
    - **客服机器人**: 智能客服自动回复
    - **社交媒体**: 多平台内容自动发布
    - **通知系统**: 多渠道消息推送

=== "业务流程"
    - **订单处理**: 电商订单自动化处理
    - **发票管理**: 发票生成和跟踪
    - **库存管理**: 库存监控和补货提醒
    - **客户关系**: CRM数据同步和更新

=== "AI增强"
    - **内容生成**: AI辅助内容创作
    - **图像处理**: 批量图像分析和处理
    - **文档分析**: 智能文档解析和提取
    - **情感分析**: 用户反馈情感分析

## 🎯 热门模板详解

### 1. 每日天气邮件推送

**应用场景**: 每天定时获取天气信息并发送邮件提醒

**模板代码**:
```json
{
  "name": "Daily Weather Email",
  "nodes": [
    {
      "parameters": {
        "rule": {
          "interval": [{"field": "cronExpression", "value": "0 8 * * *"}]
        }
      },
      "name": "Schedule Trigger",
      "type": "n8n-nodes-base.scheduleTrigger",
      "typeVersion": 1,
      "position": [240, 300]
    },
    {
      "parameters": {
        "url": "https://api.openweathermap.org/data/2.5/weather",
        "qs": {
          "q": "Beijing",
          "appid": "={{$credentials.openWeatherMap.apiKey}}",
          "units": "metric"
        }
      },
      "name": "Get Weather",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 1,
      "position": [460, 300]
    }
  ],
  "connections": {
    "Schedule Trigger": {"main": [["Get Weather"]]}
  }
}
```

**配置要点**:
- 配置OpenWeatherMap凭证
- 设置目标城市
- 自定义邮件模板

### 2. GitHub提交通知Slack

**应用场景**: GitHub代码提交时自动通知Slack频道

**核心节点**:
- Webhook Trigger (GitHub)
- Set Node (数据处理)
- Slack Node (消息发送)

**效果**: 开发团队实时了解代码更新情况

### 3. Excel报表自动生成

**应用场景**: 定期从数据库提取数据生成Excel报表

**工作流程**：定时触发 → 数据库查询 → 数据处理 → Excel生成 → 邮件发送

## 🛠️ 模板定制指南

### 基础定制

1. **修改触发条件**
   - 调整定时频率
   - 更改触发事件
   - 添加条件过滤

2. **更新数据源**
   - 替换API端点
   - 更改数据库连接
   - 修改文件路径

3. **调整输出格式**
   - 自定义邮件模板
   - 修改通知内容
   - 更改数据格式

### 高级定制

=== "添加错误处理"
    ```javascript
    // 在关键节点添加错误处理
    try {
      const result = await processData();
      return result;
    } catch (error) {
      // 发送错误通知
      await sendErrorNotification(error);
      throw error;
    }
    ```

=== "性能优化"
    ```javascript
    // 批量处理优化
    const batchSize = 10;
    const results = [];
    
    for (let i = 0; i < items.length; i += batchSize) {
      const batch = items.slice(i, i + batchSize);
      const batchResults = await Promise.all(
        batch.map(processItem)
      );
      results.push(...batchResults);
    }
    ```

=== "动态配置"
    ```javascript
    // 从环境变量读取配置
    const config = {
      apiUrl: process.env.API_URL || 'https://api.example.com',
      batchSize: parseInt(process.env.BATCH_SIZE) || 10,
      retryCount: parseInt(process.env.RETRY_COUNT) || 3
    };
    ```

## 📊 模板分享最佳实践

### 创建优质模板

**模板结构**:
```yaml
模板名称: 简洁明了的名称
描述: 详细的功能说明
用途: 具体应用场景
配置要求:
  - 必需凭证
  - 环境变量
  - 外部依赖
使用说明:
  - 安装步骤
  - 配置方法
  - 测试验证
注意事项:
  - 常见问题
  - 安全提醒
  - 性能建议
```

### 模板文档模板

```markdown
# 模板名称

## 功能描述
简要描述模板的主要功能和价值

## 应用场景
- 场景1：具体使用情况
- 场景2：另一个使用情况

## 前置要求
- [ ] n8n版本要求
- [ ] 必需的凭证配置
- [ ] 外部服务依赖

## 安装使用
1. 复制模板JSON代码
2. 在n8n中粘贴
3. 配置必要的凭证
4. 调整参数设置
5. 测试运行

## 配置说明
### 必需配置
- **API密钥**: 用于xxx服务认证
- **邮箱凭证**: 用于发送通知邮件

### 可选配置
- **执行频率**: 默认每天执行一次
- **数据过滤**: 可添加筛选条件

## 常见问题
### Q: 无法连接API
A: 检查API密钥是否正确配置

### Q: 邮件发送失败
A: 验证SMTP设置和凭证配置

## 版本历史
- v1.0: 基础功能实现
- v1.1: 添加错误处理
- v1.2: 性能优化
```

## 🎨 自定义模板开发

### 模板设计原则

1. **通用性**: 模板应该适用于多种类似场景
2. **可配置**: 关键参数应该容易修改
3. **健壮性**: 包含适当的错误处理
4. **文档化**: 提供清晰的使用说明

### 模板测试清单

```yaml
功能测试:
  ✅ 正常流程执行成功
  ✅ 边界情况处理正确
  ✅ 错误情况优雅处理

性能测试:
  ✅ 执行时间在合理范围
  ✅ 内存使用控制得当
  ✅ 并发处理能力验证

兼容性测试:
  ✅ 不同n8n版本兼容
  ✅ 各种环境下可用
  ✅ 依赖服务版本兼容

文档测试:
  ✅ 安装说明准确完整
  ✅ 配置步骤清晰易懂
  ✅ 故障排除信息有效
```

## 🌟 社区贡献

### 分享你的模板

1. **GitHub提交**: 向社区模板库提交PR
2. **官方论坛**: 在n8n社区分享经验
3. **技术博客**: 写作详细的使用教程
4. **视频演示**: 录制操作演示视频

### 模板评估标准

| 评估维度 | 优秀 | 良好 | 一般 |
|----------|------|------|------|
| **功能完整性** | 覆盖完整业务流程 | 核心功能完备 | 基础功能可用 |
| **代码质量** | 结构清晰，注释完整 | 逻辑清楚 | 基本可读 |
| **错误处理** | 全面的异常处理 | 基本错误处理 | 缺少错误处理 |
| **文档质量** | 详细的使用指南 | 基本说明 | 简单描述 |
| **通用性** | 高度可配置 | 部分可配置 | 固定场景 |

---

通过模板套用，您可以快速构建专业级的自动化工作流，站在巨人的肩膀上创造价值！

[上一章：避坑指南](pitfalls.md){ .md-button } [下一章：MCP应用](mcp.md){ .md-button .md-button--primary }