currentvalue是飞书多维表格中仅在map、filter、list等遍历函数内有效的动态占位符，代表当前处理行的对应字段值；脱离遍历上下文会报错，误用会导致空值或逻辑错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在写飞书多维表格公式时遇到“CurrentValue”报错、返回空值或结果不符合预期，根本原因往往是没理解它到底代表什么、在什么上下文中生效、为什么不能随便套用。
CurrentValue 是什么
CurrentValue 是飞书多维表格公式中唯一允许直接引用的动态占位变量，它不是函数，也不是常量，而是一个“指针”——指向当前正在被公式处理的那一条记录中的某个字段值。
比如你在「销售表」里新建一个公式字段，输入 [销售额].MAP(CurrentValue * 1.1)，这个 CurrentValue 就代表当前行的「销售额」值；如果你写的是 [书名].MAP("《" & CurrentValue & "》")，CurrentValue 就是当前行的「书名」文本内容。
它只在 MAP、FILTER、LIST 等遍历类函数内部有效，离开这些函数作用域就无法识别——直接写 CurrentValue 会报错。
CurrentValue 怎么用才不报错
方法一：在 MAP 函数中映射单列
适用场景：对某一列做统一格式转换、数值计算或字符串拼接。
第一步：选中目标字段（如「书名」）→ 点击「+ 新建字段」→ 类型选「公式」
第二步：输入公式：[书名].MAP("《" & CurrentValue & "》")
注意：双引号必须是英文状态，中文引号会导致整个公式解析失败且无提示。
方法二：在 MAP 中处理多列组合
适用场景：需要同时读取销量和单价算销售额，但两字段不在同一张表。
先用 LIST 合并两列：LIST([销量], [单价]) → 再用 MAP 遍历：LIST([销量], [单价]).MAP(CurrentValue[0] * CurrentValue[1])
【CurrentValue[0] 指第一列（销量），CurrentValue[1] 指第二列（单价），索引从 0 开始】。写成 CurrentValue[2] 或 CurrentValue[-1] 会返回空值，不报错但结果不可用。
CurrentValue 常见误用与后果
错误写法1：在非遍历函数中使用 CurrentValue
例如直接写 CurrentValue + 10 或 IF(CurrentValue > 100, "达标", "未达标") —— 这些公式会显示“公式错误”，因为 CurrentValue 缺少上下文容器，系统不知道它该指向哪一行哪一列。
错误写法2：在 FILTER 条件中漏掉 CurrentValue 前缀
比如想筛选分数大于85的记录，写成 [收集表].FILTER([分数] > 85) 是错的；正确写法是 [收集表].FILTER(CurrentValue.[分数] > 85)。漏掉 CurrentValue.[分数] 会导致条件恒为 false，返回空结果集。
错误写法3：跨表引用时混淆 CurrentValue 所属表
在汇总表中写 [明细表].FILTER(CurrentValue.[部门] == "销售部").count()，这里 CurrentValue 默认属于「明细表」，而非当前所在汇总表——如果本意是按汇总表的「部门」字段去匹配明细表，必须显式写出 [明细表].FILTER(CurrentValue.[所属部门] == [部门]).count()，其中 [部门] 才指汇总表当前行的部门值。
