CSV 导入与导出
约 1369 字大约 5 分钟
2026-03-20
如果您在电脑端有已经排好的电子表格（如 Excel），或者教务系统提供了 CSV 导出的接口，您可以通过 SleepIn 的 CSV 功能进行批量导入与备份导出。
目前支持两类数据：
- 课程表 CSV 导入与导出
- 作息表 CSV 导入与导出
课程表 CSV 导入与导出
课程表 CSV 文件格式
要使导入能够顺利读取您的数据，课程表 CSV 必须包含以下必需字段（表头/列名）：
| 列名 | 释义 | 示例 |
|---|---|---|
| 课程名称 | 就是课程名称（必填） | 线性代数 |
| 教师 | 授课教师（可选） | 张六 |
| 星期 | 星期几（数字 1-7，1 为周一，必填） | 4 |
| 开始节次 | 课程开始节次（必填） | 1 |
| 结束节次 | 课程结束节次（必填） | 2 |
| 地点 | 上课地点（可选） | 教二101 |
| 周次 | 上课周次（必填） | 1-16 |
字段格式要求：
课程名称- 必填，非空字符串。
教师- 可选字符串。
地点- 可选字符串。
星期- 必填整数，范围
1..7。
- 必填整数，范围
开始节次- 必填整数，必须在所选课程表的课时安排范围内。
结束节次- 必填整数，必须在课时范围内且
>= 开始节次。
- 必填整数，必须在课时范围内且
周次- 必填字符串，用于描述上课周数。
- 支持格式：
- 区间：
1-16 - 自定义列表：
1;3;5;7;8 - 奇偶数区间：
1-16(odd)或1-16(even) - 混合表达式：
1-4;7-9;13;14-18(odd)
- 区间：
示例：
课程名称,教师,地点,星期,开始节次,结束节次,周次
数学分析Ⅰ,张世风,主楼-A101,1,1,2,1-16
数学分析Ⅰ,张世风,主楼-A101,3,1,2,1-16
西洋剑术,哈耶西诺,体育馆,1,5,6,1-16
欧洲古典诗歌鉴赏,西哈德,B203,3,3,4,1-16(odd)
欧洲古典诗歌鉴赏,西哈德,B203,2,9,10,1-16(even)
数学物理方程,王盖澍,中心-C305,2,7,8,1;3;5;7;9
数学物理方程,王盖澍,中心-C305,5,7,8,1-16(even)
空气力学,高哲柳,东-D210,2,5,6,1-4;7-9;13;14-16(odd)
信号与系统Ⅱ,赵琳达,北-303,4,1,2,1-16
信号与系统Ⅱ,赵琳达,北-303,3,5,6,1-16(even)
马克思主义基本原理,"郭安博,夏岱琅,韩达孙",主楼C-304,2,3,4,1-16
马克思主义基本原理,"郭安博,夏岱琅,韩达孙",主楼C-304,5,5,6,1-8注意：
- SleepIn 通过列名来识别数据，因此请确保列名与上述表格中的列名完全一致，而不需要注意先后顺序。
- 导入支持
UTF-8，并兼容常见中文编码（GB18030、GBK、GB2312、Big5，以及带 BOM 的 UTF-16）。- 导出仍使用
UTF-8（含 BOM），建议优先保留该编码以获得最佳兼容性。
另外，课程表 CSV 也兼容英文表头：
CourseName、Teacher、Location、DayOfWeek、StartPeriod、EndPeriod、Weeks。
导入 CSV 课程表
- 在 SleepIn 菜单栏中选择“课程表”点击“+”创建新的课程表。
- 记住先填写好课表的基本信息再点击从 CSV 导入。
- 点击“保存并从导入 CSV”后，选择你准备好的 CSV 文件。
- 系统会自动解析 CSV 文件并将课程添加到当前课程表中。
导出 CSV 课程表备份
- 在 SleepIn 菜单栏中选择“课程表”。
- 进入要导出的课程表编辑页。
- 点击导出 CSV 并选择保存路径。
作息表 CSV 导入与导出
作息表 CSV 文件格式
作息表 CSV 采用单文件单作息表模式：
每一行表示一个课节时间段。
另外，虽然作息表名称列给人感觉可以写多个作息表，但实际上一个 CSV 文件中只能包含一个作息表名称。
同课程表一样，导入 CSV 时 SleepIn 通过列名来识别数据，因此请确保列名与下表中的列名完全一致：
| 列名 | 释义 | 示例 |
|---|---|---|
| 作息表名称 | 作息表名称（必填） | 春季作息 |
| 节次 | 第几节（必填） | 1 |
| 开始时间 | 课节开始时间（必填） | 08:00 |
| 结束时间 | 课节结束时间（必填） | 08:50 |
字段格式要求：
作息表名称- 必填，非空字符串。
- 同一文件内所有行必须是同一个作息表名称。
节次- 必填整数，且必须
> 0。
- 必填整数，且必须
开始时间、结束时间- 必填，格式为
HH:mm。 - 必须满足
结束时间 > 开始时间。
- 必填，格式为
- 作息表整体规则
- 节次不能重复。
- 不同课节时间段不能重叠。
示例：
作息表名称,节次,开始时间,结束时间
春季作息,1,08:00,08:50
春季作息,2,09:00,09:50
春季作息,3,10:10,11:00
春季作息,4,11:10,12:00作息表 CSV 也兼容英文表头：
ScheduleName、PeriodNumber、StartTime、EndTime。
导入 CSV 作息表
- 在 SleepIn 菜单栏中选择“作息表”，点击“+”创建。
- 点击“导入CSV并创建作息表”。
- 选择 CSV 文件后系统会解析并创建新的作息表。
当前不支持在“编辑已有作息表”页面导入覆盖。
导出 CSV 作息表备份
- 在 SleepIn 菜单栏中选择“作息表”。
- 进入需要导出的作息表编辑页。
- 点击“导出当前作息表CSV”并选择保存路径。
更新日志
2026/5/18 12:59
查看所有更新日志
2a526-docs(readme): update screenshot layout于