📒 创建对象

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

✅️ 对象初始化

初始化参数	类型	默认值	说明
path	str Path	None	文件路径，若不存在会自动创建
cache_size	int	1000	每调用多少次add_data()就保存，为0时不自动保存
file_type	str	None	指定文件类型，可选：'txt'、'csv'、'json'、'jsonl'、'db'、'byte'、'b'（除byte和b，字符串前面可以加'.'） 如为None则从path参数读取，path为None时本参数无效

说明

• 如创建Recorder对象时不指定文件路径，可后续用set.path()指定。
• 指向不存在的路径会在记录数据时自动创建父级路径及文件。

示例：

from DrissionRecord import Recorder

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

---

✅️ 设置文件路径

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

注意

设置新路径时，会先将已收集数据保存到原文件，并将原有header、header_row、table、data_col设置清空。

💡 set.path()

参数名称	类型	默认值	说明
path	str Path	必填	文件路径
file_type	str	None	指定文件类型，可与文件后缀不一致。可选：'txt'、'csv'、'json'、'jsonl'、'db'、'byte'、'b'（除byte和b，字符串前面可以加'.'）

返回类型	说明
Setter	设置对象

说明

• 'byte'格式可设置为'b'，二者等价。
• xlsx 格式文件必须保持后缀为'xlsx'，不能设置其它值。
• 除'byte'和'b'，文件类型前面可以加'.'，如'.txt'

---

以下示例中，设置新路径是 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'、'db'、'byte'、'b'（除byte和b，字符串前面可以加'.'）

返回类型	说明
Setter	设置对象

说明

• 'byte'格式可设置为'b'，二者等价。
• xlsx 格式文件必须保持后缀为'xlsx'，不能设置其它值。
• 除'byte'和'b'，文件类型前面可以加'.'，如'.txt'

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

from DrissionRecord import Recorder

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