如何解决PYQGIS导入Excel文件时首行被识别为表头的问题

OGR驱动默认会把Excel的第一行识别为字段表头，要让第一行作为普通数据行导入，需要在URI中添加noHeader=YES参数，同时建议明确指定工作表名称（避免默认匹配的不确定性）。

修改后的完整代码如下：

# 构造带参数的URI，指定工作表和不启用表头识别
uri = r"C:\Users\6503-0249\Desktop\Expropriation\SALE\TEST.xlsx|layername=Sheet1&noHeader=YES"

# 创建矢量图层并添加到项目
vlayer = QgsVectorLayer(uri, "TEST数据", "ogr")
if vlayer.isValid():
    QgsProject.instance().addMapLayer(vlayer)
else:
    print("图层加载失败：", vlayer.error().message())

参数说明： #

• layername=Sheet1：指定要导入的Excel工作表名称，根据你的实际表名修改（比如Sheet2、数据页等）
• noHeader=YES：强制OGR不将第一行作为字段名，所有字段会自动命名为field_1、field_2...，第一行内容会作为第一条数据记录保留

内容的提问来源于stack exchange，提问作者สายน้ํา พิทักษ์บูรพา