你是不是也遇到过这种“无节点可用”的尴尬？

在 N8N 大学，我们每天都会收到读者的私信：“大神，n8n 能不能对接我公司的内部系统？”或者“这个冷门 API 怎么没有现成的节点？”

老实说，n8n 的生态已经很丰富了，但面对海量的 SaaS 工具和私有化部署，官方节点永远不可能覆盖 100% 的场景。这时候，很多人会选择绕路，比如先用 Python 写个脚本再通过 HTTP 调用，或者干脆放弃自动化。

其实，n8n 最硬核的能力在于它允许你“造轮子”。今天，笔者就带你手把手实战，从零构建一个自定义节点。这不仅能解决眼前的问题，更能让你彻底理解 n8n 的底层逻辑。

准备工作：磨刀不误砍柴工

在开始写代码之前，我们需要打通开发环境。别担心，这比你想象的要简单。

1. Node.js 环境：确保你的电脑安装了 Node.js（建议 v16 以上版本）。这是运行 n8n 开发工具的基石。
2. n8n CLI 工具：我们需要使用官方提供的脚手架工具。在终端运行 npm install -g n8n-node-dev 即可安装。
3. 一个简单的 API：为了演示，笔者准备了一个免费的公共 API（JSONPlaceholder），用于获取用户数据。你可以替换为任何你想对接的 API。

准备好这些，我们就可以开始创建项目了。记住，自定义节点本质上就是一段 TypeScript/JavaScript 代码，它定义了输入、输出和处理逻辑。

核心实操：构建你的第一个 API 节点

我们将创建一个名为 n8n-nodes-custom-user-fetcher 的节点。它的功能很简单：接收一个用户 ID，通过 API 获取该用户的详细信息。

步骤 1：初始化节点项目

打开终端，进入你想要存放代码的目录，运行以下命令：

n8n-node-dev new

系统会提示你输入节点的名称（如 n8n-nodes-custom-user-fetcher）和描述。按照提示操作，脚手架会自动生成标准的项目结构。这一步非常关键，因为它帮你处理了 Webpack 配置和依赖库。

步骤 2：编写节点逻辑 (src/nodes/UserFetcher.ts)

这是最硬核的部分。在生成的 src/nodes 目录下，找到对应的文件。我们需要定义两个核心部分：接口 (Interface) 和 执行逻辑 (Execute)。

首先，定义输入参数。我们希望用户在界面上输入一个 ID：

// 这是一个简化的代码片段
const fields = [
  {
    displayName: 'User ID',
    name: 'userId',
    type: 'string',
    default: '',
    placeholder: '例如: 1',
    description: '要获取的用户 ID',
  },
];

接下来，编写实际的 API 调用逻辑。我们使用 n8n 内置的 httpRequest 方法：

const items = this.getInputData();
const item = items[0];
const userId = item.json.userId; // 获取用户输入的 ID

// 调用 API
const responseData = await this.helpers.httpRequest({
  method: 'GET',
  url: `https://jsonplaceholder.typicode.com/users/${userId}`,
});

// 将结果输出
return [this.helpers.jsonToItem(responseData)];

这里的 this.helpers.httpRequest 是 n8n 提供的封装方法，它自动处理了 Header、代理和错误提示，比原生的 fetch 好用太多。

步骤 3：本地编译与测试

代码写好了，怎么在 n8n 界面里看到它？回到终端，运行：

n8n-node-dev start

这个命令会启动一个监听模式，实时编译你的代码。此时，你需要找到你的 n8n 实例（如果是本地安装，通常在 ~/.n8n 目录），将开发中的节点链接进去。

通常，我们需要在 n8n 的配置文件中增加自定义节点的路径，或者直接将编译后的包放入 custom 节点目录。对于开发版，最直接的方式是运行 n8n 时指定环境变量：

N8N_NODES_CUSTOM=/path/to/your/node/project n8n start

重启 n8n 后，按 Ctrl + R 刷新界面，搜索 "User Fetcher"，你就能看到自己创建的节点了！拖拽一个节点，输入 ID，运行，看到结果的那一刻，成就感爆棚。