从零理解 n8n 工作流 ↗
先认识触发器、节点和数据流。
n8n 将多个节点连接成工作流。触发器决定何时开始，后续节点读取上游数据并产生输出。先用手动触发器加 Edit Fields 节点设置一个 message 字段，点击执行，检查输出面板中的 JSON。
开始时保持工作流未激活。分开测试单个节点与完整流程，确认每个节点收到的输入符合预期，再添加外部服务。
官方文档 ↗LEARN N8N
一步一步，掌握自动化
按入门、实战与上线顺序阅读，配合模板完成练习。
导入模板与首次配置 ↗
导入 JSON 后还需要重新配置连接。
下载模板后，在自己的 n8n 编辑器中通过菜单导入文件，或粘贴复制的节点。导入不会替你创建账户、授权 API 或填好业务数据。
首先检查节点类型与目标 n8n 版本，安装确实需要的社区节点。再逐项设置凭据、URL、数据表和字段；小批量手动执行，确认结果后才激活。
官方文档 ↗理解 items 与表达式 ↗
用输入输出面板定位字段。
n8n 节点通常处理一个或多个 item，每个 item 包含 JSON 数据。表达式例如 {{$json.title}} 读取当前 item 的 title。上游没有这个字段时，不应直接假设它存在。
从节点输出面板拖入字段，检查字符串、数字、数组和空值。多个来源合并后注意 item 对应关系，使用测试样本覆盖缺失字段。
官方文档 ↗凭据与敏感信息 ↗
把 API 密钥保存在自己的凭据库。
在 n8n 的 Credentials 中配置服务连接，不要将密钥直接写入节点参数、URL 查询字符串或 Code 节点。本站下载模板移除了凭据引用，导入后需重新绑定。
分享前检查导出的节点、HTTP 请求头、测试数据和执行输出。自动脱敏不能识别所有业务隐私，发布人仍需人工检查。
官方文档 ↗Webhook 接收外部事件 ↗
测试地址和生产地址用途不同。
Webhook 节点接收外部请求。调试时在编辑器监听测试事件，调用测试地址；上线后按实例配置使用生产地址。响应节点需与 Webhook 的响应方式配套。
为生产接口配置鉴权、限制请求体，并考虑重复请求。不能仅凭难猜的 URL 代替身份验证；涉及写入或通知时增加幂等标识。
官方文档 ↗定时任务与时区 ↗
先确认执行时区再设置计划。
Schedule Trigger 用于周期任务。检查工作流或实例的时区设置，确认界面显示的触发时间符合业务地区。激活前先手动验证后续节点。
定时采集需要记录上次处理位置，避免重复导入。请求频率根据来源约束设置；失败时保留进度，恢复后从断点继续。
官方文档 ↗HTTP 请求与分页 ↗
逐页采集并处理接口错误。
HTTP Request 节点可以调用 API。先根据官方接口文档设置方法、地址、鉴权和请求体，检查状态码与返回结构。不要把第三方网页地址当成 JSON API。
分页字段因接口而异；设置最大页数、速率限制和结束条件。遇到 401、403、429 时分别处理身份、访问限制和退避，不能绕过来源验证。
官方文档 ↗RSS 新闻收集入门 ↗
从公开 Feed 收集标题和来源。
RSS Read 读取公开订阅地址。输出字段受 Feed 内容影响，先检查标题、链接和日期，再映射到自己的内容表。以来源链接或 GUID 去重。
资讯收集保留原始来源、采集时间与审核状态。发布原创摘要；全文与图片转载需确认授权。单个 Feed 失败不应阻塞其他来源。
官方文档 ↗AI 节点与模型成本 ↗
将模型输出视为需要校验的数据。
AI 流程一般包含输入整理、模型请求、结果校验与后续动作。配置模型服务的凭据，明确希望返回的字段，并对缺失字段设置处理分支。
先用少量样本估算调用次数与费用。模型可能返回不准确的结果；新闻发布、财务或对外通知应经过人工复核，不直接根据模型输出执行高影响操作。
官方文档 ↗错误处理与重试 ↗
保留失败上下文和重试边界。
在执行记录中找到失败节点，核对输入、响应与错误类型。网络暂时失败可以有限次数重试，字段错误需要修改数据或逻辑。
使用 Error Trigger 或实例提供的错误工作流机制通知维护人。对写入操作先设计幂等处理，避免重试产生重复订单、邮件或记录。
官方文档 ↗社区节点与版本兼容 ↗
安装前检查维护状态与权限。
社区节点由第三方维护，模板出现相关节点时，先查节点包、作者、支持版本和所需凭据。未安装的节点可能导致导入后无法执行。
升级前备份工作流，在独立环境测试。涉及代码、命令、文件或外部网络的节点需检查其具体行为，工作流结构通过校验并不代表已经实际运行验证。
官方文档 ↗从测试到上线的检查 ↗
小规模试运行，再开放自动执行。
核对目标版本、凭据、时区、来源访问权限、输出去向与错误处理。先使用不含敏感信息的样本执行，检查数据正确性与下游副作用。
记录测试版本、日期、输入和实际结果。模板更新后重新核验。将 n8n 作为向客户提供的托管服务前，应根据具体使用方式查看 n8n 官方许可说明。
官方文档 ↗