Python读取CSV列名失败 GitLab流水线报KeyError: 'Names'问题

安全阿岳

2026-8-8

问题：CSV解析抛出KeyError: 'Names'，本地正常但GitLab流水线失败

我用以下Python代码提取CSV单列数据，本地VM运行正常，但GitLab流水线中执行时抛出KeyError: 'Names'：

import csv

# 读取test.csv文件
with open('test.csv', 'r') as csv_file:
    reader = csv.DictReader(csv_file)
    data = [row['Names'] for row in reader]
print(data)

test.csv仅含一列数据，内容如下：

Names
John
Mary
Smith
paul

预期输出：

['John', 'Mary', 'Smith', 'paul']

同时，在GitLab仓库中打开该CSV文件时，会提示：

无法自动检测分隔符；默认使用","
（原提示：Failed to render the CSV file for the following reasons: Unable to auto-detect delimiter; defaulted to ","）

原因

问题根源是CSV分隔符的自动检测差异。你的CSV是无列分隔符的单列格式，本地环境的csv模块能正确识别，但GitLab的解析器和流水线环境中的csv模块误判了分隔符，导致表头Names未被正确识别，最终触发KeyError。

解决方法

方法1：强制指定分隔符

给DictReader指定一个数据中不存在的分隔符（比如'|'），确保单列数据被正确解析：

import csv

with open('test.csv', 'r') as csv_file:
    reader = csv.DictReader(csv_file, delimiter='|')
    data = [row['Names'] for row in reader]
print(data)

方法2：改用csv.reader读取

如果不需要字典格式，直接用csv.reader跳过表头后读取每行的第一个元素，逻辑更简单：

import csv

with open('test.csv', 'r') as csv_file:
    reader = csv.reader(csv_file)
    next(reader)  # 跳过表头行
    data = [row[0] for row in reader]
print(data)