n8n 入门教程：做出你的第一个工作流

开始之前

你需要一个 n8n 实例。最快的是申请 n8n Cloud 试用，自托管的也一样用（第 4 课会用 Docker 装一个）。n8n 的快速入门不要求写过代码。碰到不熟的词，可以先看什么是 n8n，里面讲了节点、触发器和凭据。

天气数据来自 n8n 自己托管的示例 API，所以整个快速入门只填一个网址，不用配凭据。它大约覆盖 40 个欧洲城市，别的城市会返回错误。本课和快速入门一样，用柏林。

快速入门还有条捷径：把想要的工作流说给 n8n Assistant 听，确认它列出的步骤。n8n 说，在套餐或版本带有 Assistant 的情况下，大约五分钟就能完成。亲手搭学得更多，所以下面走手动这条路。

一步步操作（附截图）

这个工作流每天早上自己醒来，取回柏林的天气，写成一句话，存进一张表。每搭一个节点就顺手改个名字，因为默认名字到第三个节点前后就很难分辨了。第 4 步要在 report 字段里填下面这段内容：

The temperature in {{ $json.city }} is {{ $json.temp_c }}°C. It's currently {{ $json.condition }}.

1. 全新的实例，首页上有 Build a workflow（创建工作流）。选它，再选空白画布上的 Add first step（添加第一步）。在询问“什么触发这个工作流”的面板里，选 On a schedule（按计划）。

   

2. Trigger Interval 保持 Days，打开 Trigger at Hour，选 8am。点标题，把节点改名为 Every day at 8 AM。黄色提示说，发布之后它才会按这个计划运行。

   

3. 关掉窗口，在触发器后面点 +，搜索 http，选 HTTP Request。在 URL 里填 https://mockingbird.n8n.io/v1/weather/berlin，再选 Execute step，然后把节点改名为 Get Berlin weather。输出里列出 city、temp_c 和 condition。图里的地址是拍摄那台电脑上的替身地址，所以数值会和你的不一样。

   

4. 点 +，选 Data transformation，再选 Edit Fields (Set)。添加一个叫 report 的字段，Value 照上面那句话来写：文字自己输入，city、temp_c 和 condition 从 INPUT 面板拖进来。选 Execute step，节点改名为 Add weather report。

   

5. 点 +，添加一个 Data table 节点，操作选 Insert row。打开 Data table 下拉框，选 Create new data table。n8n 会为它新开一个浏览器标签页。

   

6. 在新标签页里给表起名，选 Create。再选 Add Column，名称填 report，类型保持 string，选 Add Column。然后关掉这个标签页。

   

7. 回到工作流标签页，选中你的表，把 Mapping Column Mode 设为 Map Automatically，节点改名为 Save weather log。关掉窗口，点顶部的 My workflow，把工作流改名为 Weather Log。选画布下方的 Execute。运行结束后，每个节点都显示绿色对勾。

   

8. 打开 Personal，再打开 Data tables，然后打开你的表。新的一行里，就是工作流写下的那句话。

   

n8n 2.46.6 自托管在 Windows 的 Docker 里，截图拍摄于 2026 年 11 月 6 日。图里的天气接口是拍摄用电脑上的替身，代替 n8n 的示例接口。

发布它

截图停在一次测试运行上。要让定时器替你干活，还差最后一步。

1. 选择画布顶部的 Publish，按提示完成。
2. 从此这个工作流每天早上 8 点按工作流的时区自己运行。第二天早上，打开那张表，看有没有第二行。

数据怎样从一个节点传到下一个

每个节点交给下一个节点的，都是一组数据项（item），每一项是一个对象。n8n 的数据结构说明说得很直接：节点之间传的所有数据，都是对象组成的数组。普通的值放在 json 键下，文件放在 binary 键下。一个节点收到好几项，就会逐项处理。

数据不用你手动连线。把 INPUT 面板里的字段拖进某个参数，n8n 就替你写好表达式，比如拖入 fruit 得到 {{ $json.fruit }}。一个字段可以填固定值，也可以填表达式，切到表达式模式后还可以直接手写。花括号里面是 JavaScript。

测试运行、生产运行和发布

工作流跑一次，叫一次执行。选 Execute 启动的是手动执行，用来测试。发布之后的工作流，会自己产生生产执行。付费套餐的配额只计生产执行，所以在编辑器里测试不会占用它。

打开 Executions 标签页，能看到这个工作流过去的每次运行。失败的运行选 Debug in editor，成功的运行选 Copy to editor。无论哪种，n8n 都会把那次运行的数据复制进你的工作流，并固定在第一个节点上，这样你改好某一步，就能用同一份数据重跑。这个功能在 n8n Cloud 和自托管的 Registered Community、Business、Enterprise 版里都有，注册社区版实例是免费的。

触发器里的 8 点，按的是工作流的时区，工作流没设时区就按实例的时区，这是 Schedule Trigger 说明里写的。自托管实例默认是 America/New York。n8n Cloud 会在注册时尝试识别所有者的时区，识别不了就用 GMT。等明天那一行数据之前，先确认你用的是哪个时区。

n8n 官方团队怎么说数据表和 Assistant 搭的工作流

2025 年 9 月 22 日，n8n 团队在 X 上发布了数据表，当时放在 1.113.0 的预发布版里。帖子说，它是 n8n 自带的存储，不用外部数据库，也不用凭据，可以在多次运行之间保存状态。本课的 Save weather log 节点做的正是这件事：每天早上 8 点跑一次，就多一行，之前几次运行的结果都留在表里。

一年后，2026 年 9 月 10 日，团队在 X 上发了一串讲 n8n Assistant 的帖子，你描述目标，它替你搭工作流。团队在其中一条回复里提醒，Assistant 不一定第一次就把每个工作流都搭对。所以走快速入门里 Assistant 那条捷径时，要像对待自己手搭的工作流一样对待它：发布之前，在 Executions 标签页里打开那次运行，看每个节点收到了什么、送出了什么。

X 官方嵌入卡片的截图，拍摄于 2026 年 11 月 5 日，时间为 UTC。X 在第一条帖子处用“Show more”截断了后面的内容。点击截图可到 X 上打开原帖。

常见错误

• 忘了发布。定时触发器要等你保存并发布工作流之后才会触发，所以测试全通过的工作流，照样可能一直闲着。
• 用了示例 API 没有的城市。大约 40 个欧洲城市之外的城市，都会返回错误。
• 引用了还没运行过的节点。像 $('Get Berlin weather') 这样的表达式，在你把工作流测试到那个节点之前，会报“Referenced node is unexecuted”。
• 在固定值字段里直接敲花括号。先把字段切到表达式模式，或者从 INPUT 面板拖值进来。
• 把一次绿色的测试结果当成定时一定会跑。Execute 只是现在立刻跑一遍。早上 8 点那次能不能跑，取决于有没有发布，以及时区对不对。

自己试一试

每次只改一处，改完就把工作流跑一遍。

• 把网址里的 berlin 换成别的城市。如果报错，说明示例 API 不覆盖那个城市。
• 在 Edit Fields 里再加一个字段，把 temp_c 换算成华氏度。表达式就是 JavaScript，所以 {{ $json.temp_c * 9 / 5 + 32 }} 可以作为起点。给数据表加一个对应的列，再看新增的那一行。
• 打开 Executions 标签页，选中你的那次运行，找出每一列数据分别是哪个节点产生的。
• 把触发器改成按分钟的间隔，发布，看着新行一条条出现。试完取消发布，或者改回去。

接下来学什么

你的工作流是靠时钟启动的。很多实际的工作流是被别的应用调用才启动，这就是 Webhook 节点，也就是第 2 课的内容。第 3 课在同一块画布上搭一个 AI 智能体。如果想直接从现成的工作流学起，可以从 Mindket 的 n8n 工作流里导入一个，每个模板的节点在下载前就已经画出来了。

常见问题

资料来源

1. n8n Docs: Build your first workflow (2026年11月4日 查阅)https://docs.n8n.io/build-your-first-workflow
2. n8n Docs: Understand n8n's data structure (2026年11月4日 查阅)https://docs.n8n.io/build/work-with-data/understand-n8ns-data-structure
3. n8n Docs: Expressions for data transformation (2026年11月4日 查阅)https://docs.n8n.io/build/work-with-data/transform-data/expressions-for-data-transformation
4. n8n Docs: Expression reference (2026年11月4日 查阅)https://docs.n8n.io/build/work-with-data/transform-data/expression-reference
5. n8n Docs: Understand executions (2026年11月4日 查阅)https://docs.n8n.io/build/understand-workflows/understand-executions
6. n8n Docs: Debug executions (2026年11月4日 查阅)https://docs.n8n.io/build/understand-workflows/understand-executions/debug-executions
7. n8n Docs: Key concept glossary (2026年11月4日 查阅)https://docs.n8n.io/key-concept-glossary
8. n8n Docs: Schedule Trigger node (2026年11月4日 查阅)https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.scheduletrigger
9. n8n Docs: Edit Fields (Set) node (2026年11月4日 查阅)https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.set
10. n8n Docs: HTTP Request node (2026年11月4日 查阅)https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest
11. n8n Docs: Choose how to use n8n (2026年11月4日 查阅)https://docs.n8n.io/choose-how-to-use-n8n
12. n8n Docs: Learning paths (2026年11月5日 查阅)https://docs.n8n.io/learning-paths
13. n8n.io on X: data tables are here, 22 September 2025 (2026年11月5日 查阅)https://x.com/n8n_io/status/1970148748840874288
14. n8n.io on X: n8n Assistant is live, check the execution logs, 10 September 2026 (2026年11月5日 查阅)https://x.com/n8n_io/status/2097996379301741038
15. n8n on YouTube: n8n Quick Start Tutorial: Build Your First Workflow [2025] (2026年11月5日 查阅)https://www.youtube.com/watch?v=4cQWJViybAQ