# n8n-study

**Repository Path**: zychhf/n8n-study

## Basic Information

- **Project Name**: n8n-study
- **Description**: 高质量的 n8n 中文教程与实战手册，涵盖核心概念、环境部署、节点详解、调试与进阶技巧，配套案例与截图，帮助快速上手并构建稳定的自动化工作流。
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-13
- **Last Updated**: 2026-01-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# n8n 中文学习教程 🚀

> **前景提要**：这份教程专门为小白选手、非程序员准备的系统学习教程。如果你有一定基础，或者只是想查某个节点的操作，不用跟着这套流程，跳着阅读就行。
> 
> 我认为最可靠的学习方法是：
> 1. 花 1-2 天熟悉 n8n 界面和基本操作
> 2. 跟着 YouTube 视频教程模仿 2-3 个工作流
> 3. 开始自己的创作，带着问题和需求去探索
> 
> 记得踩在前人肩膀上才能走更高，推荐这个仓库：[awesome-n8n-templates](https://github.com/enescingoz/awesome-n8n-templates) 参考改造或创作属于你自己的工作流。

> 💡 **学习重点**：不要追求一步到位。先让流程"跑通"，再逐步优化。

> 一个完整的 n8n 工作流自动化学习教程，帮你从零开始掌握 n8n，构建智能自动化解决方案

## ⚠️ 学习前必读

### 📋 前置条件
- **时间投入**：每天 1-2 小时，坚持 4 周
- **硬件要求**：能运行 Docker 的电脑（Windows/Mac/Linux）
- **网络要求**：能访问 GitHub、Docker Hub（建议科学上网）

### 🎯 适合人群
- ✅ **完全小白**：想学自动化但不知道从哪开始
- ✅ **职场人士**：想提升工作效率，减少重复劳动
- ✅ **AI 爱好者**：想让 AI 真正帮你"动手干活"
- ✅ **技术探索者**：对低代码和自动化感兴趣

### ❌ 不适合人群
- ❌ **追求完美**：希望系统 100% 稳定，零错误
- ❌ **急功近利**：想 1 天就掌握所有技能
- ❌ **纯理论派**：只喜欢看书，不喜欢动手实践

## 📚 这个教程能帮你做什么？

这是一个**系统化的 n8n 学习教程项目**，专门为小白设计：

- 🎯 **从零开始**：不需要编程基础，用大白话教你 n8n
- 🚀 **系统学习**：按照 4 周学习路线，一步步掌握核心技能
- 🛠️ **实战应用**：3 个真实项目案例，边学边做
- 🤖 **AI 增强**：学会让 AI 真正为你"动手干活"
- 💼 **实用技能**：掌握未来工作的核心能力

> **核心理念**：让 AI 拥有"手脚"，而不是只会聊天。n8n 就是给 AI 装上行动能力的"现代魔法"。

## 📁 项目结构（实际内容）

```
n8n/
│
├── 01_教程导览/                    # 🎯 学习指南
│   └── 00-学习路线图.md           # 4周学习计划（详细版）
│
├── 02_核心概念/                    # 🧠 理论基础
│   ├── 00-什么是n8n.md           # n8n 核心概念详解
│   └── 01-AI时代的自动化思维.md   # AI 与自动化结合
│
├── 03_环境部署/                    # 🛠️ 环境搭建
│   └── 本地安装指南.md            # 本地环境安装
│
├── 04_节点详解/                    # 🔧 节点功能详解
│   ├── 00-从需求找节点.md         # 节点选择指南
│   ├── 01-常用逻辑节点介绍.md     # If/Switch/Merge/Loop
│   ├── 02-AI节点详细介绍.md       # LLM Chain/Agent
│   ├── 03-半开放式节点详细介绍.md # Code/HTTP Request
│   ├── 04-n8n内建变量与方法.md    # 表达式速查
│   ├── 05-n8n中如何使用MCP.md     # MCP 协议使用
│   └── images/                   # 节点配置截图
│
├── 05_调试与排错/                  # 🔍 问题诊断
│   └── 00-单步调试与测试案例.md   # 调试技巧
│
├── 06_实战案例/                    # 🎯 真实项目
│   ├── 01-检查网站sitemap状态/    # 网站监控工作流（学习HTTP请求、条件判断）
│   ├── 02-爬虫爬取网站数据/       # 数据抓取工作流（学习数据处理、AI清洗）
│   └── 03-使用Google Veo3生成AI视频/ # AI视频生成（学习轮询、文件处理、第三方集成）
│
├── 07_一些小技巧/                  # 🚀 进阶技巧
│   └── 进阶技巧.md                # 实战经验总结
│
└── 08_资源工具箱/                  # 🛠️ 实用资源
    └── 推荐阅读清单.md            # 学习资源汇总
```

> **说明**：这是实际的项目结构，每个文件夹都有对应的详细教程和实战案例。

## 🎯 为什么选择 n8n？

### 🔗 强大的集成能力
- **1000+ 第三方服务**：Google Sheets、Notion、飞书、企业微信等
- **半封装模式**：既可以用现成节点，也能插入 JavaScript/Python 代码
- **BYOK 支持**：用自己的 OpenAI API 密钥，灵活控制成本

### 🤖 AI 友好设计
- **内置 LangChain 节点**：轻松集成 GPT、通义千问等大模型
- **可视化 AI 编排**：不用写代码就能让 AI 参与决策和处理
- **记忆与工具链**：支持 AI Agent 的复杂推理流程

### 💻 适合个人和小团队
- **私有化部署**：数据完全由你掌控，更安全
- **"寄生系统"**：为现有系统"打补丁"或"加外挂"
- **快速迭代**：先让流程跑通，再逐步优化

## 📖 学习资源

### 📚 官方资源（参考）
- [n8n 官方文档](https://docs.n8n.io/) - 没事尽量不要看，该文档本身就不是用来学习的
- [n8n 社区论坛](https://community.n8n.io/) - 遇到问题可以求助
- [n8n 工作流案例库](https://n8n.io/workflows/) - 官方示例

### 🎥 视频教程（推荐）
- [n8n 官方 YouTube](https://www.youtube.com/c/n8n-io) - 官方视频教程
- [Bilibili n8n 相关视频](https://search.bilibili.com/all?keyword=n8n) - 中文视频

### 🛠️ 实用工具（必收藏）
- [awesome-n8n-templates](https://github.com/enescingoz/awesome-n8n-templates) - **必看**，大量现成工作流

### 🆚 与其他工具对比
| 工具 | 优势 | 劣势 | 适合场景 |
|------|------|------|----------|
| **n8n** | 私有部署、AI友好、1000+集成 | 学习曲线陡峭 | 个人/小团队、需要AI集成 |
| **Zapier** | 简单易用、稳定 | 仅云服务、AI功能弱 | 轻量级自动化 |
| **Coze** | 字节生态、AI强 | 仅云服务、集成少 | 字节系用户 |
| **Dify.ai** | AI Agent专业 | 集成少、复杂 | 专注AI应用开发 |

## 🤝 获取帮助

### 💬 遇到问题怎么办？
1. **先看本教程**：`05_调试与排错/00-单步调试与测试案例.md`
2. **问 ChatGPT**：截图发错误信息，让 AI 帮你分析
3. **社区求助**：[n8n Community](https://community.n8n.io/)
4. **GitHub Issues**：[n8n Issues](https://github.com/n8n-io/n8n/issues)

### 🛠️ 推荐工具
- **沉浸式翻译**：浏览英文文档时自动翻译
- **ChatGPT / Gemini**：结对编程助手，帮你写代码、分析报错
- **Postman**：调试 API 接口，然后 Import cURL 到 n8n

### 📝 贡献指南
欢迎改进这个教程！如果你想贡献：

1. **Fork 项目**：复制到你的账户
2. **创建分支**：为你的贡献创建新分支
3. **提交更改**：提交你的改进和修复
4. **发起 PR**：创建 Pull Request

## 🎉 学完后你能做什么？

完成本教程后，你将能够：

### 🎯 核心技能
- ✅ **独立设计工作流**：从需求分析到流程搭建
- ✅ **集成第三方服务**：Google Sheets、Notion、企业微信等
- ✅ **让 AI 真正干活**：调用 GPT 进行智能决策和处理
- ✅ **解决实际问题**：自动化你的重复性工作

### 🚀 进阶能力
- ✅ **调试和优化**：单步调试、错误处理、性能优化
- ✅ **半开放式节点**：用 Code/HTTP Request 补齐能力
- ✅ **MCP 集成**：让 AI 调用你的 n8n 工作流
- ✅ **实战项目**：完成 3 个真实项目案例

### 💼 实际价值
- ✅ **提升效率**：让重复工作自动化，节省时间
- ✅ **AI 协作**：从 AI 使用者变成 AI 指挥官
- ✅ **技能升级**：掌握未来工作的核心能力
- ✅ **个人品牌**：拥有自己的"移动城堡"

## 🔮 学习心法（必读）

### 💡 核心原则
1. **不要追求"完全理解"**  
   → 很多配置（如 OAuth）你可能不懂原理，但只要"work"了就先用着。

2. **善用搜索引擎和 AI**  
   → 报错信息 → 截图 → 丢给 ChatGPT："这个 n8n 错误怎么解决？"

3. **从小处着手，快速迭代**  
   → 先做"最小可用流程"，再逐步加功能。

4. **把 n8n 当"寄生系统"**  
   → 不改变现有业务，只在上面加一层自动化"外挂"。

5. **接受不完美**  
   → 低代码的稳定性不如工程系统，但胜在**灵活、快速、自由**。

### 🧭 学习建议
- **目标明确**：知道要学什么，学到什么程度
- **循序渐进**：按照教程顺序学习
- **动手实践**：理论结合实践，学以致用
- **社区交流**：与他人分享，共同进步

## 🏁 结语：打造你的"移动城堡"

> "n8n 生产出来的流程更像是手工艺制品，或者是哈尔的移动城堡。"  
> —— 它可能歪歪扭扭，但它属于你，它能动，它能帮你干活。

当你完成第一个自动化流程时，你会感受到一种前所未有的力量：
- **你不再是工具的使用者，而是工具的制造者。**
- **你不再是 AI 的听众，而是 AI 的指挥官。**

### 🎯 开始你的 n8n 学习之旅

**现在就开始吧！** 🚀
**祝学习顺利，早日成为 n8n 专家！** 🎉

---

<div align="center">

**如果这个教程对你有帮助，请给它一个 ⭐ Star！**

[![GitHub stars](https://img.shields.io/github/stars/eleven-h/n8n?style=social)](https://github.com/eleven-h/n8n)
[![GitHub forks](https://img.shields.io/github/forks/eleven-h/n8n?style=social)](https://github.com/eleven-h/n8n)
[![GitHub issues](https://img.shields.io/github/issues/eleven-h/n8n)](https://github.com/eleven-h/n8n/issues)

</div>