n8n 核心功能：能力清单与关键配置
核心功能：能力清单与关键配置
| 能力 | 说明 | 关键配置点 |
|---|---|---|
| Trigger 类型 | Webhook、Schedule（固定间隔）、Cron、表单提交、聊天触发、被其它 workflow 调用、手动触发、应用事件（如邮件到达、文件变更） | 生产与测试 webhook 是两条不同 URL；Schedule 与 Cron 都受实例时区影响 |
| 核心节点 | HTTP Request、Set（改名与赋值）、IF 与 Switch（分支）、Merge（合并）、Split Out（拆条）、Item Lists（列表操作）、Wait（延时与等待外部恢复）、Loop Over Items（循环） | HTTP Request 的认证方式建议走 credential，不要硬编码 token |
| 表达式 | 在参数中用 {{ }} 写 JS 语法，访问 $json、$node["节点名"].json、$items()、$execution.id、$workflow.id、$now、$env | 表达式只求值不执行副作用；复杂逻辑放 Code 节点更好维护 |
| Code 节点 | 写 JavaScript 或 Python，支持 Run Once for All Items 与 Run Once for Each Item 两种模式 | 用 $input.all() 拿全部 item，用 return [{ json: {...} }] 返回；默认不放开外部依赖 |
| 错误工作流 | 为 workflow 指定一个 Error Workflow，由 Error Trigger 节点接收失败事件 | 在 workflow 设置里指定；错误工作流自身要能发通知，否则等于没配 |
| 子工作流 | 用 Execute Sub-workflow 节点调用另一个 workflow，被调方以 Execute Workflow Trigger 作为入口 | 适合把通用逻辑抽出来复用；注意主调与被调之间的数据契约要固定 |
| 错误处理 | 节点级 Continue On Fail、Retry On Fail 与统一错误工作流三种粒度 | 外部 API 调用建议开重试并设置退避 |
| 版本控制与导出 | 用 CLI 导出导入 workflow 与 credential，配合 git 做变更留痕 | 导出的是 JSON，不含凭据明文；部分版本提供更完整的环境与源码管理能力，以官方文档为准 |
| Executions 管理 | 查看每次执行的输入输出、耗时、状态，可一键重跑 | 人工执行与生产执行在列表里可区分 |
CLI 导出导入是自托管场景做备份和迁移的基本手段：
n8n export:workflow --all --output=./backup/workflows.json
n8n export:credentials --all --output=./backup/credentials.json
n8n import:workflow --input=./backup/workflows.json
n8n list:workflow注意凭据导出是密文加解密后的可迁移形式，导入到新实例时仍然需要相同的 N8N_ENCRYPTION_KEY，否则无法使用。没有这个 key，导出的凭据文件等于废纸。
