扣子工作流中怎么使用代码节点编写Python/JS逻辑

顾言

发布时间：2026-10-23 | 4人浏览过

原创

有时候，预设的“文本处理”或“条件判断”节点就像一把瑞士军刀，虽然方便，但遇到需要精确裁剪的数据格式或者复杂的数学计算时，总觉得差点意思。比如你想把用户输入的杂乱日期统一转换成标准格式，或者对一组数字进行去重排序，这时候就需要请出工作流里的“特种兵”——代码节点。

代码节点允许你直接嵌入 Python 或 JavaScript 代码，这意味着你可以利用成熟的编程语言库来处理那些拖拽式节点搞不定的逻辑。别被“写代码”吓到，在扣子的工作流里，你不需要搭建环境，也不用担心依赖冲突，只需要关注核心逻辑本身。

添加并配置代码节点

在工作流编辑页面，从左侧组件栏找到“代码”节点，拖拽到画布合适的位置。点击该节点，右侧面板会出现配置界面。这里最关键的两个选择是“语言”和“输入参数”。

目前扣子主要支持 Python 3 和 JavaScript (Node.js) 两种环境。如果你熟悉数据处理，Python 通常是首选，因为它的字符串处理和列表操作非常直观；如果你更习惯前端逻辑或者需要处理 JSON 结构，JavaScript 也是不错的选择。

扣子工作流中怎么使用代码节点编写Python/JS逻辑

代码节点配置面板，显示语言选择和输入参数定义区域

在“输入参数”区域，你需要定义代码能接收哪些变量。这就像给函数定义参数一样。例如，如果你要处理一段文本，可以添加一个名为 input_text 的参数，类型选择“String”，并引用上游节点的输出作为值。记住，这里定义的变量名，就是你在代码里直接使用的变量名，大小写必须完全一致。

编写核心逻辑

进入代码编辑区，你会看到一个默认的模板。不要删除顶部的注释部分，那是系统自动生成的输入映射。你的任务是在 def main(args): (Python) 或 function main(args) (JS) 中编写逻辑。

假设我们要做一个简单的功能：接收一个名字列表，返回去重并按字母排序后的结果。

如果是 Python，代码可能长这样：

def main(args):
    # 获取输入参数
    names = args.get('name_list', [])
    
    # 业务逻辑：去重并排序
    if isinstance(names, list):
        unique_names = list(set(names))
        sorted_names = sorted(unique_names)
    else:
        sorted_names = []
        
    # 返回结果，必须是字典格式
    return {
        "result": sorted_names
    }

注意看最后一行，return 的内容必须是一个字典（Dict）。这是因为工作流需要通过键值对来识别输出结果。如果你只返回一个字符串或列表，系统会报错，提示输出格式不正确。

扣子工作流中怎么使用代码节点编写Python/JS逻辑

代码编辑器中编写的Python去重排序逻辑

如果是 JavaScript，逻辑类似，但语法稍有不同：

function main(args) {
    // 获取输入参数
    let names = args.name_list || [];
    
    // 业务逻辑：去重并排序
    let uniqueNames = [...new Set(names)];
    let sortedNames = uniqueNames.sort();
    
    // 返回结果，必须是对象格式
    return {
        result: sortedNames
    };
}

无论选哪种语言，核心原则是一样的：读取 args 中的输入，处理数据，最后以对象/字典形式返回结果。不要在代码里尝试打印日志到控制台来调试，工作流环境通常不直接显示 stdout，你应该通过返回特定的错误信息字段来排查问题。