PhpSpreadsheet下拉列表如何实现选中值映射为另一列单元格值

Excel 原生的数据验证（下拉列表）本身不直接支持「选项展示值和单元格实际存储值不一致」的特性，我们可以通过以下两种成熟方案实现需求： #

方案1：函数联动实现（无宏，兼容性最好） #

实现逻辑：搭配VLOOKUP函数做值映射，可按需隐藏辅助操作列，最终效果符合预期且所有Excel环境都能正常运行，无需启用宏权限，是最推荐的实现方式。
示例场景：映射关系存放在映射表工作表，A列是下拉展示的文本（如AAA）、B列是对应要填充的数值（如111），在主表的C列实现「选AAA自动填111」的效果。

具体代码实现 #

1. 写入映射数据源，可隐藏映射表避免用户误改

// 创建映射表并写入数据
$mappingSheet = $spreadsheet->createSheet();
$mappingSheet->setTitle('映射表');
// 批量写入映射关系，可根据你的实际数据调整
$mappingData = [
    ['AAA', '111'],
    ['BBB', '222'],
    ['CCC', '333']
];
foreach ($mappingData as $k => $item) {
    $row = $k + 1;
    $mappingSheet->setCellValue('A' . $row, $item[0])
        ->setCellValue('B' . $row, $item[1]);
}
// 隐藏映射表
$mappingSheet->setSheetState(\PhpOffice\PhpSpreadsheet\Worksheet\Worksheet::SHEETSTATE_HIDDEN);

2. 给主表设置下拉选项和联动函数
   我们用主表D列做下拉选择的辅助列，C列作为实际展示数值的列，也可以把D列隐藏，用户操作时无感知：

$mainSheet = $spreadsheet->getActiveSheet();
// 给C列设置操作提示
$mainSheet->setCellValue('C1', '请点击右侧单元格选择选项');
// 给D1单元格设置下拉验证
$validation = $mainSheet->getCell('D1')->getDataValidation();
$validation->setType(\PhpOffice\PhpSpreadsheet\Cell\DataValidation::TYPE_LIST);
$validation->setErrorStyle(\PhpOffice\PhpSpreadsheet\Cell\DataValidation::STYLE_STOP);
$validation->setAllowBlank(true);
$validation->setShowDropDown(true);
// 下拉选项引用映射表A列的展示文本
$validation->setFormula1('映射表!$A$1:$A$' . count($mappingData));
// C1单元格写入VLOOKUP函数，自动匹配D1选中值对应的数值
$mainSheet->setCellValue('C1', '=IFERROR(VLOOKUP(D1,映射表!$A:$B,2,FALSE),"")');
// 可选：隐藏D列，用户看不到辅助列
$mainSheet->getColumnDimension('D')->setVisible(false);

方案2：同单元格自动替换（需宏，仅支持xlsm格式） #

如果要求必须在同一个单元格完成「选AAA后单元格自动变为111」的操作，需要写入VBA宏代码，生成的文件需保存为xlsm格式，且用户打开文件时需要启用宏才能生效。
核心VBA逻辑为工作表的Change事件，检测到下拉单元格值变化时自动替换为映射数值，核心VBA片段参考：

Private Sub Worksheet_Change(ByVal Target As Range)
    If Not Intersect(Target, Range("A:A")) Is Nothing Then
        Application.EnableEvents = False
        Target.Value = Application.VLookup(Target.Value, Sheets("映射表").Range("A:B"), 2, False)
        Application.EnableEvents = True
    End If
End Sub

内容的提问来源于stack exchange，提问作者Mim0uth