n8n 工作流怎样交给同事：JSON 导出、凭据引用与迁移验收

先写清交接对象 同事只是学习一个字段转换，通常不需要整套生产流程；迁移完整业务时，则需要记录关联工作流、凭据和触发器配置。建议交接前列出目标范围，保留输入输出样例，并说明哪些依赖需要接收者重新配置。 导出保存的是工作流结构 n8n 官方说明，工作流以 JSON 保存，可通过界面下载、从文件或 URL 导入，也可以复制粘贴选中节点。局部演示时，可以只分享相关节点，但要检查引用的上游节点是否一并存在。能粘贴进画布不代表所有引用已经完整。 分享前检查凭据相关内容 文档提醒，导出的工作流 JSON 包含凭据名称与 ID；名称可能透露内部信息。由 cURL 导入的 HTTP Request 节点还可能含有认证请求头。因此应逐项检查实际 JSON，移除不需要的认证字面值并匿名化内部名称，不能仅凭“凭据通常单独保存”就忽略文件内容。 给接收者明确的配置说明，例如需要哪类服务凭据和哪项访问能力，不要把真实令牌作为示例值写进教程。 导入后先核对环境差异 目标实例可能缺少节点、使用不同版本或采用不同项目结构。编辑建议先检查全部节点能否加载，再配置凭据和必要引用，最后运行不产生实际业务副作用的样例。若流程包含写入步骤，沿用团队已有测试环境验证，避免把测试数据写入正式系统。 给文件附上一张能照着复现的交接说明 以“读取订单后生成摘要”为例，说明里至少写清：输入 order_id；需要订单查询服务与模型服务凭据；引用的子工作流名称和用途；输出 order_id、summary；缺少订单号时应返回什么。再给一份虚构的 O-1001 订单，写出摘要中必须出现的金额与状态，接收者才能判断结果是否正确。 分享局部节点时，特别检查表达式中按名称引用的上游节点。例如摘要节点仍引用“查询订单”，但文件只包含摘要节点，导入后就缺少数据来源。修复办法是补齐必要节点，或把交接片段改成接收明确输入的结构，并相应更新样例。 处理认证字段时，保留接收者需要理解的字段结构，把值改为明确占位内容，并说明在哪里绑定自己的凭据。不要把整段认证配置无说明地删掉，导致对方把认证失败误判为业务逻辑错误。最终交接应包含工作流文件、依赖说明和一组预期输出，三者指向同一版本。 不要把打包能力与单个 JSON 混淆 所核对文档还介绍了处于 Preview 的 n8n packages，用于携带工作流及相关文件夹、项目和引用。它与下载当前工作流 JSON 的范围不同，迁移前应按实际版本核对支持情况。本文不声称任何一种导出会自动迁走所有运行数据和服务配置。 用交接验收替代“导入成功” 让接收者用正常输入、缺失字段和外部服务不可用三类样例检查结果。交接记录保留源版本、导出时间、依赖清单与预期输出，出现差异时能定位到配置或逻辑。文件能打开只是第一步，真正完成交接是接收者能理解并复现该工作流的用途。

本篇涉及的工具1

n8n

导出、导入或复制工作流节点，交接结构与可复现的处理逻辑。

适合场景

需要共享 n8n 工作流、迁移环境或给同事提供可复现示例的维护者。

需要留意

单个 JSON 的范围有限，需补齐引用、凭据配置和运行依赖。

了解项目 访问官网