如何用xlwings将Excel含指定字符串的行设为DataFrame列标题

需求明确 #

找到Excel中第一列包含指定字符串（如F2）的行，将该行作为Pandas DataFrame的列标题，同时保留该行之后的所有数据行。

原代码问题分析 #

你之前的xlwings代码出错核心原因是行号计算错误：

• pd.read_excel默认会把Excel第一行作为DataFrame的列名，因此返回的df索引是0-based，对应Excel第2行及以后的内容
• 你直接把row_index（pandas索引）作为Excel行号使用，但Excel行号是1-based，还得加上原表头占的1行，所以正确的Excel目标行号应该是row_index + 2

另外，其实不用xlwings，纯Pandas就能高效完成需求，下面给出两种可行方案：

方案一：纯Pandas实现（推荐） #

无需依赖xlwings，代码更简洁高效：

import pandas as pd

file = "你的Excel文件路径.xlsx"
sheet_name = "Sheet1"
search_value = "F2"

# 读取整个Excel，不预设表头（所有行都作为数据行）
full_data = pd.read_excel(file, sheet_name=sheet_name, header=None)

# 定位第一列等于目标字符串的行索引（0-based）
target_row_idx = full_data[full_data.iloc[:, 0] == search_value].index[0]

# 生成目标DataFrame：目标行做列名，后续行做数据
result_df = pd.DataFrame(
    data=full_data.iloc[target_row_idx+1:].values,
    columns=full_data.iloc[target_row_idx].values
)

print(result_df)

方案二：修正原xlwings代码 #

如果你必须用xlwings，只需修正行号计算逻辑：

import pandas as pd
import xlwings as xw

file = "你的Excel文件路径.xlsx"
sheet_name = 'Sheet1'
search_value = 'F2'

# 获取目标行的pandas索引
df = pd.read_excel(file, sheet_name=sheet_name.strip())
row_index = df[df.iloc[:, 0] == search_value].index[0]

# 修正Excel行号：pandas索引+2（原表头占1行，Excel行号从1开始）
starting_row = row_index + 2

# 后台启动Excel，避免弹出窗口
app = xw.App(visible=False)
wb = app.books.open(file)     
data_range = wb.sheets[sheet_name].range(f'A{starting_row}').options(
    pd.DataFrame, header=True, index=False, expand='table'
).value
 
wb.close()
app.quit()

print('############### DATAFRAME #################')
print(data_range)

验证结果 #

两种方案最终都会生成符合预期的DataFrame：

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