Help us learn about your current experience with the documentation. Take the survey.

CSV 文件

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

逗号分隔值(CSV)文件是一种使用逗号分隔值的分隔文本文件。 文件的每一行都是一个数据记录。每个记录由一个或多个字段组成,字段之间用逗号分隔。 使用逗号作为字段分隔符是这种文件格式名称的来源。 CSV 文件通常以纯文本形式存储表格数据(数字和文本),在这种情况下,每一行的字段数量相同。

CSV 文件格式没有完全标准化。其他字符也可以用作列分隔符。 字段可能被包围也可能不被包围,以转义特殊字符。

当添加到仓库中时,带有 .csv 扩展名的文件在 GitLab 中查看时会呈现为表格:

CSV file rendered as a table

CSV 解析注意事项

GitLab 使用 Papa Parse 库来解析 CSV 文件。 该库遵循 RFC4180 标准,并有严格的格式要求,这可能导致某些 CSV 格式出现解析问题。

例如:

  • 逗号(,)分隔符和双引号(")周围的空格可能导致解析错误。
  • 同时包含逗号和双引号的字段可能导致解析器错误识别字段边界。

以下格式会导致解析错误:

"field1", "field2", "field3"

以下格式解析成功:

"field1","field2","field3"

如果您的 CSV 文件在 GitLab 中显示不正确:

  • 如果字段用双引号(")包围,请确保双引号和逗号(,)分隔符紧邻,中间没有空格。
  • 将所有包含特殊字符的字段用双引号(")包围。
  • 在进行更改后,测试 CSV 文件在 GitLab 中的显示效果。

这些解析要求仅影响 CSV 文件的视觉呈现,不会影响存储在您仓库中的实际文件内容。