在项目管理工具里做数据导出，看起来是个基础操作。但到了Linear这儿，还真得讲点门道。

你没法像在Excel里那样直接右键另存为。系统只提供了两种正经途径：内置导出功能或者调用API。

而且默认情况下一肚子限制——只能导出当前视图筛选后的Issue列表。自定义字段的计算逻辑、附件、评论历史、子任务层级关系统统不带。下面把具体做法和坑点掰开揉碎说清楚。

通过网页端导出当前视图的Issue列表

第一步，打开Linear并确保你登录的账号有导出权限——起码得是Member或Admin角色。然后进到目标团队或者项目的工作区。

用顶部搜索栏或者左侧导航栏找到包含你想要的Issue的视图。比如Inbox、Backlog或者你自己建的过滤视图。

找到视图后，点右上角的（更多操作按钮），选择Export issues。这时候会弹出一个确认框，让你勾选要导出的字段。

默认勾了Title、Status、Priority、Assignee、Labels、Created、Updated这些。但注意，【自定义字段不会自动跟着出来，你必须手动把它们勾上】，否则导出去就丢了。

勾好之后点Export，浏览器就会自动下载一个叫linear-issues-export.csv的文件。这个文件是UTF-8编码、逗号分隔的标准CSV，用Excel直接打开没问题。

使用Linear API批量导出完整数据

如果网页端那个导出满足不了你——比如想把全部Issue、评论、关联关系都弄出来，或者想定时同步，那就得上API了。

第一步：创建API Token

去Linear的API设置页面（在应用里找API settings），点“Create new token”。给Token起个名，比如“data-backup”。

权限勾上read:issues和read:comments，生成后把Token复制下来。

第二步：使用curl或Python脚本发起请求

下面给个最小可行的curl示例。把YOUR_API_TOKEN和TEAM_ID换成你自己的：

curl -H "Authorization: Bearer YOUR_API_TOKEN" -H "Content-Type: application/json" "https://api.linear.app/graphql" --data '{ "query": "query Issues($first: Int!) { issues(first: $first) { nodes { id title status { name } assignee { name } createdAt updatedAt labels { nodes { name } } } } }" , "variables": { "first": 100 } }'

这里有个关键点：Linear的GraphQL API单次最多只返回100条Issue。要想拿到全部数据，必须配合after游标来做分页拉取。很多人第一次写的时候忘记处理游标，结果只拿到开头100条，剩下的全丢了。

第三步：将API返回的JSON转为CSV

API返回的是JSON格式，保存成issues-full.json。然后你需要用pandas或者jq这类工具把它转成CSV——这一步不能跳过，API不给你原生CSV输出。

导出限制与数据校验要点

导出来的CSV文件里，Labels那一列看起来是用英文逗号分隔的多个标签。别担心，Linear已经用双引号把整个字段包起来了，Excel打开不会错列。但如果你用文本编辑器直接看，可能会觉得有点乱。

另一个常踩的坑：如果导出后发现日期列显示的是Unix时间戳（比如1718892345），说明当前视图开了“Raw data mode”。在导出之前，去视图右上角里取消勾选“Show raw values”就行。

必须明确的是，附件、截图、投票数、评论全文——这些内容【不会出现在任何导出结果里】，包括API响应。

想拿到这些数据？只能上Linear的Web界面人工看，或者借助第三方集成工具。比如Zapier配个Google Sheets间接捕获。

最后提醒一句：导出的CSV没有表头行的字段类型声明。Excel可能会把带斜杠的版本号（比如“v2.1.0”）误认成日期。导入时最好用“从文本导入向导”，把对应列手动设为“文本”格式，省得数据变形。

《夸克》非常好用的免费AI浏览器

下载APP查看