Skip to main content
Benny的老巢 Logo
Overview

【n8n入门教程06】n8n 常用节点完全指南：从文件操作到代码执行

January 9, 2026
2 min read
n8n
节点
文件操作
HTTP
代码执行
自动化

n8n入门教程系列目录

【n8n入门教程01】n8n工作流自动化平台架构解析与核心概念详解

【n8n入门教程02】macOS安装n8n保姆级教程-Homebrew与npm两种方式详解

【n8n入门教程03】n8n变量配置与多输入数据合并完整指南

【n8n入门教程04】n8n权限与路径管理全指南：避免常见错误，保障数据安全

【n8n入门教程05】n8n Workflow编辑器完全指南：从入门到精通

【n8n入门教程06】n8n常用节点完全指南：从文件操作到代码执行

【n8n入门教程07】n8n插件机制与扩展方式完全指南

【n8n入门教程08】n8n触发节点完全指南：定时器、Webhook和手动触发

【n8n入门教程09】n8n Code与Execute Command节点深度对比与最佳实践

【n8n入门教程10】n8n本地程序集成完全指南：使用Execute Command节点

【n8n入门教程11】n8n大模型集成完全指南：调用OpenAI和Gemini API

【n8n入门教程12】n8n PDF翻译自动化实战：从英文PDF到中文PDF

【n8n入门教程13】n8n常见问题与调试技巧完全指南

n8n 常用节点完全指南：从文件操作到代码执行

在 n8n 这个自动化平台里，节点就是实现数据处理、集成和流程控制的核心组件。无论是读取文件、调用 API，还是进行条件判断和代码执行，都离不开各种节点。今天我就来详细介绍最常用的核心节点，包括它们的功能、配置要点和典型应用场景，帮你快速掌握 n8n 的节点使用技巧。

文件读写节点：本地自动化的基础

文件读写是本地自动化的基础操作，n8n 提供了 “Read/Write Files from Disk” 节点来处理本地服务器上的文件。

读取文件（Read File）

选择 “Read File” 操作后，你需要指定文件的完整路径。节点会把文件内容作为二进制数据输出，存储在 $binary.data 字段中，同时 $json 会附带文件名、大小等元信息。

使用场景：

  • 批量读取配置文件
  • 处理上传的文件
  • 读取数据文件（CSV、JSON等）

配置要点：

  • 路径支持表达式，可以动态指定文件名
  • 支持批量读取多个文件
  • 输出数据包含完整的文件元信息

写入文件（Write File）

选择 “Write File” 操作，需要指定目标路径和文件名。你可以选择输入数据的来源（$binary.data 或 $json.data），支持文本和二进制两种写入模式。

使用场景：

  • 保存处理后的数据
  • 生成报告文件
  • 备份重要数据

配置要点：

  • 写入成功后会输出文件信息
  • 目录需要提前创建（n8n 不会自动创建目录）
  • 建议使用绝对路径，特别是在 Docker 环境下

重要提示：文件读写节点只在自托管的 n8n 实例中可用，n8n Cloud 不支持本地文件操作。

HTTP 请求节点：最通用的集成工具

HTTP Request 节点可以说是 n8n 里最通用的集成工具了，几乎可以和任何支持 HTTP 的服务对接。

基本配置

请求方法：支持下拉选择 HTTP 动词，包括 GET、POST、PUT、PATCH、DELETE 等。

URL：填写完整的请求地址，支持参数化和表达式。比如可以用 {{ $json.id }} 这样的表达式动态构建 URL。

认证：可以选择预定义的凭据，或者自定义 Header（比如 Bearer Token）。

请求参数：

  • Headers：自定义请求头
  • Query Parameters：URL 查询参数
  • Body：请求体，支持多种格式（JSON、表单、二进制等）

响应解析：默认会解析 JSON 响应为 $json，如果需要完整的响应信息（包括状态码、响应头等），可以选择 “Full Response” 模式。

典型应用场景

调用 REST API：和第三方服务集成，比如调用微信 API、钉钉 API 等。

数据抓取：从网页或 API 获取数据。

发送数据：把处理好的数据推送到外部系统。

Webhook 回调：在流程完成后通知外部系统。

条件判断与分批处理节点：实现分支和循环

自动化流程经常需要根据不同条件走不同的分支，或者批量处理大量数据。n8n 提供了 IF 节点和 Loop Over Items 节点来满足这些需求。

IF 条件判断节点

IF 节点可以根据条件表达式把数据分流到不同的分支。

配置方法：

  • 设置条件表达式，支持多条件组合（AND/OR）
  • 条件为真的数据走 true 分支
  • 条件为假的数据走 false 分支

使用场景：

  • 数据验证：检查字段是否符合要求
  • 错误处理：根据错误类型走不同的处理流程
  • 业务分支：根据订单状态走不同的处理逻辑

示例：

条件：{{ $json.status === 'completed' }}

Loop Over Items 节点（原 SplitInBatches）

这个节点用于按批次处理输入数据，特别适合处理大量数据或者需要分页的场景。

配置要点：

  • Batch Size：设置每批处理的数据量
  • Options：可以设置重试选项、延迟等

使用场景：

  • 批量调用 API：避免一次性发送太多请求
  • 分页处理：处理需要分页获取的数据
  • 循环处理：配合 IF 节点实现循环逻辑

典型流程：

数据源 → Loop Over Items → HTTP Request → 合并结果

代码节点：实现自定义逻辑

当内置节点无法满足需求时，Code 节点就派上用场了。它允许你在工作流中编写自定义 JavaScript 或 Python 代码。

使用场景

复杂数据处理：进行复杂的数据转换、计算。

格式转换：把数据从一种格式转换成另一种格式。

算法实现：实现特定的业务逻辑或算法。

数据验证：编写自定义的验证规则。

配置示例（JavaScript）

// 访问输入数据
const items = $input.all();


// 处理数据
const processed = items.map(item => {
  const data = item.json;
  return {
    json: {
      id: data.id,
      processed: true,
      timestamp: new Date().toISOString()
    }
  };
});


// 返回处理后的数据
return processed;

配置示例（Python）

# 访问输入数据
items = $input.all()


# 处理数据
processed = []
for item in items:
    data = item['json']
    processed.append({
        'json': {
            'id': data['id'],
            'processed': True,
            'timestamp': datetime.now().isoformat()
        }
    })


# 返回处理后的数据
return processed

命令执行节点：调用系统命令

Execute Command 节点允许你在工作流中执行系统命令，这个功能很强大，但也要注意安全性。

使用场景

系统管理：执行系统管理任务。

文件操作：使用系统命令处理文件。

调用脚本：执行 Shell 脚本或其他可执行文件。

数据处理：调用系统工具处理数据。

配置要点

Command：要执行的命令，支持表达式。

Options：

  • Working Directory：指定工作目录
  • Environment Variables：设置环境变量
  • Output Format：选择输出格式

安全建议

  • 不要在命令中直接使用用户输入
  • 使用参数化而不是字符串拼接
  • 限制可执行的命令范围
  • 在生产环境中谨慎使用

其他常用节点

除了上面介绍的节点，n8n 还有很多其他常用节点，这里简单提一下：

Set 节点

用于设置或修改数据字段，可以添加、删除、重命名字段，是数据转换的基础工具。

Merge 节点

用于合并多个数据流，支持多种合并模式（Append、Combine、Merge By Key 等）。

Switch 节点

类似于 IF 节点，但支持多个条件分支，适合多路选择场景。

Wait 节点

用于在流程中添加延迟，比如等待某个操作完成。

Sleep 节点

让工作流暂停指定时间，适合定时任务场景。

Filter 节点

根据条件过滤数据，只保留符合条件的数据项。

Item Lists 节点

用于操作数据列表，比如拆分列表、合并列表等。

节点组合技巧

掌握了单个节点的使用后，关键在于如何把它们组合起来实现复杂的自动化流程。这里分享几个实用的组合技巧：

数据处理流水线

读取数据 → 验证 → 转换 → 处理 → 保存

错误处理模式

主要流程 → IF 判断成功 → 继续处理
               ↓
            失败 → 记录错误 → 发送通知

批量处理模式

数据源 → Loop Over Items → 处理单个项目 → 合并结果 → 输出

条件分支模式

数据源 → Switch → 分支1 → 处理1 → 合并
                → 分支2 → 处理2 → 合并
                → 分支3 → 处理3 → 合并

总结

n8n 的节点系统设计得很灵活，几乎可以满足各种自动化需求。掌握这些常用节点的使用方法，你就能够构建出强大的自动化工作流了。

记住几个关键点：

  • 文件操作要注意路径和权限
  • HTTP 请求要处理好认证和错误
  • 条件和循环节点要合理设计逻辑
  • 代码节点要谨慎使用，注意性能和安全
  • 命令执行节点要注意安全风险

多练习、多实践，你会发现 n8n 的节点系统功能强大且易于使用。如果你需要更详细的信息，可以查阅 n8n 官方文档，里面有每个节点的详细说明和示例。