CSV甘特图模板：文件格式与它画出的排期
CSV甘特图模板：14项任务的数据迁移计划、描述它的CSV（Task、Group、Duration、Depends on）以及算出的排期。看清要输入、加引号和粘贴的内容。
什么是CSV甘特图模板：文件格式与它画出的排期流程
CSV是计划流转的格式。项目工具导出它，同事用邮件发送它，电子表格保存它，甘特图工具则被要求读取它。流程图要考虑怎么写箭头，甘特图则简单得多，因为一项任务只需要四样东西：名称、工期、分组和它所等待的任务。其余的，日期、条形和完成时间，都由计算得出。
本模板是一次数据迁移，其输入本身就是CSV文件：从旧系统导出、清洗、映射到新字段、试装载、对账，然后正式装载。下面的文件就是这份计划的CSV，所用的列正是你粘贴时QueryChart甘特表读取的列。表头按名称匹配，顺序不限，至少要识别出两列（表头使用英文名称：Task任务、Group分组、Duration工期、Depends on前置任务）。Task列最关键；Duration以整数工作日计，0表示里程碑；Group画出阶段分带；Depends on列出该任务所等待的任务。
三个细节决定CSV能否顺利粘贴。Depends on里有用逗号分隔的多个任务编号，所以该字段必须用双引号括起来，而只有当该字段确实是单个单元格时，CSV写入工具才会替你加上。若添加Start（开始）或End（完成）列，日期请用yyyy-mm-dd：它在任何语言下读法都相同，而像3/4这样的数字日期按界面语言的顺序读取，可能是3月4日，也可能是4月3日。Status列会被当作进度读取，也就是百分比或Done一词，其他说法无法识别。
甘特图目前还不支持上传文件。请用任意文本编辑器或电子表格打开CSV，复制包括表头在内的各行，粘贴到表格中。它下方出现的就是排期。
本流程图涵盖的内容
本模板包含
- 四个分组，抽取、转换、装载和验证，共14项任务和两个里程碑：“收到CSV文件”和“映射已签字确认”，另有“验证通过”作为最终装载前的关口。
- 文本形式的文件：图表下方的CSV块，四列，Depends on字段在含有多个任务时加了引号。
- 重叠的工作：“将源字段映射到目标字段”在“收到CSV文件”开始一个工作日后开始，与“数据剖析与清洗”并行。
- 两条验证线：“核对数量与合计”和“用户抽查样本记录”都在“修复装载错误”之后，“验证通过”要等两者都完成。
- 算出的排期：每个日期都来自文件中的工期和依赖关系，而不是日期列。
何时使用本模板
- 你有来自项目工具或电子表格的CSV计划，想把它看成甘特图。
- 你要用脚本或模板生成计划，需要知道确切的列和加引号规则。
- 向甘特表粘贴时一部分被拒绝，你想看一份能用的文件。
- 你想要一份数据迁移、ETL或导入项目的起步计划。
逐项任务的计划
图表中的每项任务，含以工作日计的工期及其前置任务。依赖关系用步骤编号表示；SS 为开始到开始，FF 为完成到完成，+n 为以工作日计的延迟。
| # | 任务 | 分组 | 工作日 | 依赖于 |
|---|---|---|---|---|
| 1 | 确定范围与数据负责人 | 抽取 | 3 | |
| 2 | 将源数据导出为CSV | 抽取 | 4 | 1 |
| 3 | 收到CSV文件 | 抽取 | 里程碑 | 2 |
| 4 | 数据剖析与清洗 | 转换 | 8 | 3 |
| 5 | 将源字段映射到目标字段 | 转换 | 5 | 3SS+1 |
| 6 | 映射已签字确认 | 转换 | 里程碑 | 4, 5 |
| 7 | 试装载到测试系统 | 装载 | 3 | 6 |
| 8 | 修复装载错误 | 装载 | 4 | 7 |
| 9 | 核对数量与合计 | 验证 | 3 | 8 |
| 10 | 用户抽查样本记录 | 验证 | 4 | 8SS+2 |
| 11 | 验证通过 | 验证 | 里程碑 | 9, 10 |
| 12 | 正式装载 | 装载 | 2 | 11 |
| 13 | 归档源文件 | 验证 | 1 | 12 |
| 14 | 装载后复盘 | 验证 | 2 | 12 |
同一计划的 CSV 文件
连同表头一起复制到甘特图表格中：每一列按列名匹配。含多个任务的“前置任务”单元格带有逗号，因此加了引号。计划本身没有日期；对固定的任务，可添加“开始”列并填入 ISO 日期（2026-04-03）。
Task,Group,Duration,Depends on
确定范围与数据负责人,抽取,3,
将源数据导出为CSV,抽取,4,1
收到CSV文件,抽取,0,2
数据剖析与清洗,转换,8,3
将源字段映射到目标字段,转换,5,3SS+1
映射已签字确认,转换,0,"4, 5"
试装载到测试系统,装载,3,6
修复装载错误,装载,4,7
核对数量与合计,验证,3,8
用户抽查样本记录,验证,4,8SS+2
验证通过,验证,0,"9, 10"
正式装载,装载,2,11
归档源文件,验证,1,12
装载后复盘,验证,2,12运作方式
先写表头行
Task, Group, Duration, Depends on。只有日期固定的任务才加Start或End，有的话再加Progress、Owner或Notes。列名按名称匹配，顺序不限，至少要识别出两列。
一行一项任务
第一项任务是1号，Depends on引用的就是这个编号。每项任务保持在几天到几周之间。
给每项任务一个整数工作日的工期
里程碑用0。不存在小时和半天，请向上取整，或把很短的任务并入相邻任务。
Depends on写成数字并加引号
列出它所等待任务的编号，例如4, 5。其他类型可加SS、FF或SF，延迟用+n或-n，例如5SS+1。这类列表含有逗号，因此要用双引号括住该字段。
保存为UTF-8并检查文本
用文本编辑器打开文件看一遍：逗号作分隔符，含逗号的字段加引号，日期为yyyy-mm-dd。
复制、粘贴，并查看被拒绝的内容
复制所有行，粘贴到甘特表第一个Task单元格，并阅读警告。无法读取的日期、Depends on中不存在的任务或依赖循环都会被报告并略去。
常见问题
CSV要有哪些列才能生成甘特图？
需要任务名称，以及工期或开始与结束日期。Group、Depends on、Progress和人员都是可选的。表头行给出列名，列的顺序无关紧要。
我的Depends on列为什么乱了？
几乎总是因为含有多个任务编号的字段（如4, 5）没有加引号，逗号把它拆成了两列。请用双引号括住该字段。
可以上传CSV文件吗？
甘特图目前还不支持上传文件，请从CSV中复制各行（含表头行），粘贴到图表旁边的表格里。
行的顺序重要吗？
在一点上重要：任务的编号就是它的位置，Depends on引用的是这个编号。写好依赖之后再调整行序，会改变它们指向的任务，除非你按名称引用任务。
Status列有什么作用？
它被当作进度读取。百分比或Done一词可以识别；In progress之类的其他说法无法识别，该单元格会被标出。
