📒 创建对象

本节介绍如何创建Reocrder对象，并进行基本文件路径设置。

支持 csv、xlsx、json、jsonl、txt 五种格式文件。

✅️ 对象初始化

创建Recorder对象时，可指定文件路径，也可以不指定。

初始化参数	类型	默认值	说明
`path`	`str` `Path`	`None`	文件路径，若不存在会自动创建
`cache_size`	`int`	`1000`	每收集多少条数据自动保存，为`0`时不自动保存

说明

指向不存在的路径会自动创建父级路径及文件。

示例：

from DrissionRecord import Recorder

r = Recorder(path='data.csv')

无论初始化对象时是否指定文件路径，都可以使用set.path()方法设置新的路径。

设置新路径时，会先将已收集数据保存到原文件，并将已设置的表头数据清空。

💡 set.path()

参数名称	类型	默认值	说明
`path`	`str` `Path`	必填	文件路径
`file_type`	`str`	`None`	文件类型，可与路径后缀不一致

返回类型	说明
`RecorderSetter`	设置对象

以下示例中，设置新路径是 log 文件，但以 txt 的逻辑保存数据。

from DrissionRecord import Recorder

r = Recorder('data1.csv')
r.add_data('abc')
r.set.path('data2.log', file_type='txt')  # 设置新路径，已有数据自动保存

设置文件路径时会根据后缀名自动设置文件类型。

如文件没有后缀名，或后缀名不在支持的类型中，会默认设置为 txt 格式。

也可以用set.file_type()方法指定与后缀名不一致的类型（xlsx 文件除外）。

💡 set.file_type()

参数名称	类型	默认值	说明
`file_type`	`str`	必填	文件类型，可选`'txt'`、`'csv'`、`'json'`、`'jsonl'`，可与路径后缀不一致

返回类型	说明
`RecorderSetter`	设置对象

注意

如果是 xlsx 类型文件，文件名必须是以'.xlsx'作为后缀，否则会报错。

以下示例中，虽然指向一个.csv后缀文件，但可以显式将其设置为txt类型，后续处理会将其视为 txt 文件。

from DrissionRecord import Recorder

r = Recorder('data')  # 指向无后缀文件，自动以txt格式保存数据
r.set.file_type('txt')  # 显式指定为txt格式