pywin32无循环将pandas/numpy数组写入Excel单元格范围的实现方法

问题原因 #

Excel COM接口要求向单元格范围赋值的数组结构必须和范围的行列结构严格匹配：

• 给单列N行的范围赋值时，需要传入N行1列的二维数组（即外层列表包含N个元素，每个元素是仅含1个值的子列表）
• 你之前传入的一维numpy数组/列表会被Excel识别为单行数组，赋值给单列范围时只会重复填充第一个元素

修正方案 #

不需要额外指定VARIANT类型，只要把数据转成匹配范围的二维结构即可，以下是可直接运行的修改示例：

# 先补充你代码中缺失的变量定义，否则会触发变量不存在报错
fullFileNamePath = folderOrFilePath

# 1. 单列填充：将Series转成 (行数, 1) 结构的二维数组
# 补充：Resize明确指定行、列两个参数，避免范围识别异常
ws_obj.Cells(2, dcc.index('x')+2).Resize(df1.shape[0], 1).Value = df1['x'].to_numpy().reshape(-1, 1)

# 如果用列表结构的写法，等价于：
# ws_obj.Cells(2, dcc.index('x')+2).Resize(df1.shape[0], 1).Value = [[x] for x in df1['x'].tolist()]

# 2. 如果是多列范围填充，直接传DataFrame的values属性即可（本身就是二维结构）
# 示例：把df1前3列填充到从A2开始的范围
# ws_obj.Cells(2, 1).Resize(df1.shape[0], 3).Value = df1.iloc[:, :3].values

额外注意事项 #

1. 你之前手动构造VARIANT的操作是冗余的，pywin32会自动把符合结构的Python列表、numpy数组转成Excel可识别的Variant类型，额外封装反而可能导致类型识别错误
2. 涉及到范围赋值时，优先显式指定Resize的行、列两个参数，不要仅传行参数，避免Excel默认按行扩展导致的结构不匹配问题

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