wps-vlookup

name	wps-vlookup
description	VLOOKUP助手。帮你写VLOOKUP/INDEX-MATCH/XLOOKUP公式， 排查#N/A等常见错误，选择最合适的查找方案。 用于帮助用户解决表格查找匹配问题。当用户提到VLOOKUP、查找、匹配、#N/A时触发。 VLOOKUP formula assistant.
license	MIT
user-invocable	true
argument-hint	[查找需求描述]
allowed-tools	Read, Grep, Glob, Bash, Write, Edit
metadata	{"author":"BWKYD","title":"VLOOKUP助手","description_zh":"帮你写VLOOKUP公式，排查#N/A等常见错误","tags":["VLOOKUP","查找","匹配","公式","WPS"],"version":"1.0.2","license":"MIT"}

VLOOKUP/查找匹配专家

解决WPS表格中最高频的痛点 — 数据查找与匹配。

据统计，VLOOKUP相关问题占WPS求助帖的35%以上。

When to Use

• 需要从一张表查找另一张表的数据
• VLOOKUP返回#N/A、#REF!等错误
• 需要多条件查找/反向查找/多列返回
• 用户说"帮我写个VLOOKUP""两张表怎么关联"

When NOT to Use

• 通用公式问题 → 使用 wps-formula
• 数据透视分析 → 使用 wps-pivot

查找场景速查

场景1：基础正向查找（最常见）

需求：根据工号查姓名
公式：=VLOOKUP(A2, 员工表!A:C, 3, FALSE)

参数解释：
  A2        → 要查找的值（工号）
  员工表!A:C → 查找范围（工号在第1列）
  3         → 返回第3列（姓名）
  FALSE     → 精确匹配（99%的情况用FALSE）

场景2：反向查找（VLOOKUP做不到）

需求：根据姓名查工号（姓名在右边，工号在左边）
方案A - INDEX+MATCH（推荐）：
=INDEX(A:A, MATCH(D2, C:C, 0))

方案B - XLOOKUP（WPS 2021+）：
=XLOOKUP(D2, C:C, A:A)

场景3：多条件查找

需求：根据"部门+姓名"查找工资
方案 - INDEX+MATCH+数组：
=INDEX(C:C, MATCH(1, (A:A=E2)*(B:B=F2), 0))
（Ctrl+Shift+Enter 数组公式）

方案 - 辅助列：
辅助列公式：=A2&"|"&B2
然后VLOOKUP查找 E2&"|"&F2

场景4：模糊匹配/近似查找

需求：根据成绩查等级（60→及格，80→良好，90→优秀）
公式：=VLOOKUP(A2, 等级表, 2, TRUE)
注意：等级表第一列必须升序排列！

等级表：
  0   不及格
  60  及格
  80  良好
  90  优秀

场景5：跨工作簿查找

=VLOOKUP(A2, '[数据源.xlsx]Sheet1'!A:D, 3, FALSE)
注意：源文件必须打开，否则需要写完整路径

场景6：一次返回多列

需求：查找后返回多个字段
方案 - VLOOKUP+COLUMN：
=VLOOKUP($A2, 数据!$A:$F, COLUMN(B1), FALSE)
向右拖动自动递增列号

方案 - XLOOKUP返回数组（WPS 2021+）：
=XLOOKUP(A2, 数据!A:A, 数据!B:F)
一次返回B到F所有列

#N/A 错误诊断

VLOOKUP返回#N/A？按这个顺序排查：

1️⃣ 数据类型不一致（最常见！）
   症状：明明有这个值但就是找不到
   原因：查找值是文本"001"，表里是数字1
   修复：=VLOOKUP(VALUE(A2), ...) 或 =VLOOKUP(TEXT(A2,"000"), ...)

2️⃣ 有隐藏空格
   症状：肉眼看一样但匹配不上
   检测：=LEN(A2) 看长度是否异常
   修复：=VLOOKUP(TRIM(CLEAN(A2)), ...)

3️⃣ 查找列不在第一列
   症状：范围选错了
   修复：调整范围让查找值在第一列，或改用INDEX+MATCH

4️⃣ 第4参数写了TRUE或省略
   症状：返回错误的值
   修复：改为FALSE（精确匹配）

5️⃣ 查找范围有合并单元格
   症状：只有合并区域第一行能匹配
   修复：先取消合并 → 填充空值 → 再查找

工作流程

Step 1: 理解查找需求

确认以下信息：

• 查找什么：用什么值去查（如工号、姓名）
• 从哪里查：数据源在哪个表/文件
• 返回什么：需要取回哪些字段
• 特殊要求：多条件？模糊匹配？反向？

Step 2: 选择最佳方案

┌─ 正向查找（查找列在最左）
│  └─ 单条件 → VLOOKUP
│  └─ 多条件 → 辅助列+VLOOKUP 或 INDEX+MATCH
│
├─ 反向查找（查找列在右侧）
│  └─ INDEX+MATCH 或 XLOOKUP
│
├─ 多列返回
│  └─ VLOOKUP+COLUMN 或 XLOOKUP
│
└─ 近似/区间匹配
   └─ VLOOKUP(TRUE) 或 IFS

Step 3: 生成公式并说明

提供：

1. 完整公式（可直接粘贴使用）
2. 参数逐项说明
3. 注意事项（数据类型、排序要求等）
4. 如遇错误的排查步骤

Step 4: 提供JSA批量方案（可选）

如果查找量大或需要自动化：

// JSA: 批量VLOOKUP填充
function BatchLookup() {
    var ws = Application.ActiveSheet;
    var lookupSheet = Application.Sheets("数据源");
    var lastRow = ws.Cells(ws.Rows.Count, 1).End(-4162).Row; // xlUp

    for (var i = 2; i <= lastRow; i++) {
        var key = ws.Cells(i, 1).Value2; // A列查找值
        // 在数据源A列查找，返回C列
        var found = lookupSheet.Range("A:A").Find(key, undefined,
            -4163, 1); // xlValues, xlWhole
        if (found) {
            ws.Cells(i, 5).Value2 = lookupSheet.Cells(found.Row, 3).Value2;
        } else {
            ws.Cells(i, 5).Value2 = "未找到";
        }
    }
    Application.alert( + (lastRow - ) + );
}

VLOOKUP vs INDEX-MATCH vs XLOOKUP

特性	VLOOKUP	INDEX+MATCH	XLOOKUP
反向查找	不支持	支持	支持
插入列不影响	会错位	不受影响	不受影响
多条件	需辅助列	原生支持	原生支持
默认匹配	近似(TRUE)	精确(0)	精确
WPS兼容	所有版本	所有版本	2021+
性能	一般	较好	最好
学习难度	简单	中等	简单

示例

# 基础查找
/wps-vlookup 我有两张表，A表有工号和姓名，B表有工号和工资，怎么把工资匹配到A表

# 错误修复
/wps-vlookup VLOOKUP老是返回#N/A，明明数据都有

# 多条件
/wps-vlookup 根据部门和月份两个条件查找销售额