openpyxl写入跨本地工作簿引用公式时，方括号及工作表名被错误丢弃

问题根因 #

openpyxl 对外部工作簿引用的处理逻辑和普通内部公式存在本质区别：

• Excel 的外部引用公式并非通过纯文本格式直接生效，完整的外部引用结构包含三层：工作簿内置的外部链接注册表（存储关联文件的路径、版本信息）、公式内对应外部链接的索引值、实际跨表/跨单元格的引用路径。
• 直接对单元格value赋值带外部文件名称的字符串时，openpyxl 的内置公式解析器不会自动识别这类手写的外部引用语法，在没有预先登记对应外部链接条目的前提下，会将无法匹配结构的方括号语法、工作表标识作为无效语法直接丢弃，最终将内容简化为无意义的引用格式，这也是无论是否选择更新链接，公式格式都会被裁剪的核心原因。

正确实现外部引用的操作流程 #

• 引入openpyxl内置的外部链接处理类，先为当前工作簿注册关联的外部文件条目，再写入对应格式的公式。
  可运行的示例代码：

  from os import path
  from openpyxl import load_workbook
  from openpyxl.workbook.external_link import ExternalLink
  
  root = "你的工作文件存储路径"
  # 加载待生成的目标工作簿
  target_wb = load_workbook(path.join(root, "output_test.xlsx"))
  # 初始化外部链接对象，绑定要引用的本地外部工作簿
  ext_link = ExternalLink(path.join(root, "coe.xlsx"))
  # 将外部链接注册到当前工作簿的链接列表中
  target_wb._external_links.append(ext_link)
  
  target_sheet = target_wb["COE"]
  # 写入带外部链接索引的公式，索引值从1开始，对应列表中第n个外部链接
  target_sheet["A1"].value = "[1]COE!A1"
  
  target_wb.save(path.join(root, "output_test.xlsx"))
  

• 公式格式适配说明：预期在Excel界面显示的=[coe.xlsx]COE!A1是Excel的界面渲染格式，文件底层存储的公式使用外部链接索引号代替具体文件名，[1]代表当前工作簿登记的第一个外部链接条目。打开文件时Excel会自动匹配注册表中的路径信息，将公式渲染为预期的显示格式，不会出现方括号、工作表标识丢失的问题。

批量生成场景的适配要点 #

• 循环生成多份工作簿时，为每份目标工作簿单独创建对应路径的ExternalLink实例，不要跨工作簿复用同一个链接对象，避免出现引用错乱。
• 外部工作簿尽量和目标生成文件存放在同级目录，减少绝对路径带来的跨环境链接失效问题，移动文件时Excel可自动通过相对路径定位关联文件。
• 动态修改公式时，只需要根据当前追加的外部链接列表位置计算索引号，不需要在公式字符串中硬编码外部文件的完整名称。

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