CSV文件必须用UTF-8编码且无BOM,字段名须与{{}}内名称逐字符一致(大小写敏感、禁空格),Iterations应设为自动匹配行数,断言需用data.xxx而非pm.variables.get()。

CSV文件必须用UTF-8编码,否则中文乱码或字段错位
Postman读取CSV时默认按字节解析,非UTF-8编码(比如Windows记事本默认的ANSI或GBK)会导致首行字段名识别失败,后续所有{{username}}引用都为空。常见现象是:Runner里Preview显示“undefined”,或控制台报ReferenceError: username is not defined。
实操建议:
- 用VS Code、Notepad++或Sublime Text新建文本,手动选择“UTF-8”编码保存,后缀改为
.csv - 不要用Excel直接另存为CSV——它默认用系统本地编码,且可能插入BOM头;如必须用Excel,先另存为
CSV UTF-8 (comma delimited) (*.csv)格式(Excel 2016+才有) - 检查文件开头:用
xxd data.csv | head -1确认无ef bb bfBOM字节;有则用sed -i '1s/^\xEF\xBB\xBF//' data.csv清除
变量名必须和CSV首行完全一致,大小写敏感且不能带空格
Postman把CSV第一行当作键名,逐字映射到{{key}}。若首行写的是user_name,但请求里写{{username}},变量就无法替换,body中会原样发送{{username}}字符串。
实操建议:
- CSV首行只用英文、数字、下划线,避免中文、短横线、括号等特殊字符
- 字段名与请求中
{{}}内名称逐字符比对,推荐复制粘贴而非手打 - 空值字段留空即可,不要填
null或""——Postman会把它当字符串传过去
Collection Runner里Data文件上传后,Iterations要设为“自动”或匹配行数
如果CSV有5行数据(含首行),实际测试数据是4组,但把Iterations设成5,Postman会在第5轮尝试读取第5行数据——此时已越界,data.username为undefined,导致请求发空值或报错。
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
实操建议:
- 在Runner界面勾选
Data file iteration模式(默认开启),Postman会自动按CSV行数执行,无需手动填Iterations - 若需重复跑多轮(比如每组数据跑3次),用
-n 3配合Newman命令行,而不是在GUI里硬调Iterations - 上传后点
Preview按钮,确认显示的数据行数与你预期一致
断言里访问CSV字段要用data.xxx,不是pm.variables.get("xxx")
很多人在Tests里写pm.expect(pm.response.json().code).to.eql(pm.variables.get("expected_code")),结果始终失败——因为CSV变量不进pm.variables,而是在运行时注入全局data对象。
实操建议:
- 断言中直接用
data.expected_code,例如:pm.expect(pm.response.json().code).to.eql(data.expected_code) - 注意
data是每轮独立对象,不可跨轮修改;如需跨轮累计状态,改用pm.globals.set() - 调试时在Tests里加
console.log(data),看Console输出确认字段是否存在
CSV参数化真正卡住人的地方,往往不是语法,而是编码、字段名肉眼不可见的差异(比如全角空格)、或者误以为data变量能被脚本修改。跑不通时,先看Preview是否正常加载,再看Console里data打印结果,比反复改脚本更快。










