linear导出项目数据需通过内置功能或api：网页端仅导出当前视图issue列表（不含附件、评论、子任务及自定义字段计算逻辑），api可批量获取完整数据但需分页处理且不返回附件与评论。
在Linear中导出项目数据需依赖其内置导出功能或API调用，不支持直接右键另存为Excel或CSV文件。系统默认仅允许导出当前视图筛选后的Issue列表，且导出内容不含自定义字段计算逻辑、附件、评论历史及子任务层级关系。
通过网页端导出当前视图的Issue列表
打开Linear应用，确保已登录拥有导出权限的账号（Member或Admin角色）。
进入目标团队或项目的工作区，使用顶部搜索栏或左侧导航栏定位到包含目标Issue的视图（如“Inbox”“Backlog”或自定义过滤视图）。
点击视图右上角的⋯（更多操作）按钮→选择Export issues。
弹出导出确认框后，勾选需要导出的字段：默认包含Title、Status、Priority、Assignee、Labels、Created、Updated；【自定义字段不会自动包含，必须手动勾选】。
点击Export，浏览器将自动下载一个名为linear-issues-export.csv的文件，该文件以UTF-8编码、逗号分隔，可用Excel或文本编辑器直接打开。
使用Linear API批量导出完整数据
适用于需导出全部Issue、含评论、关联关系或定时同步的场景。
第一步：访问Linear API设置页，点击“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游标实现分页拉取；未处理游标将导致数据截断。
第三步：将返回的JSON响应保存为issues-full.json，再用pandas或jq工具转换为CSV——这一步无法跳过，API不提供原生CSV响应格式。
导出限制与数据校验要点
导出的CSV文件中，“Labels”列内容以英文逗号分隔，但实际是多个标签的合并显示，不是真正的CSV字段分隔符——Excel打开时不会错列，因Linear已用双引号包裹该字段。
若导出后发现日期列为Unix时间戳（如1718892345），说明当前视图启用了“Raw data mode”，需在导出前关闭该模式（点击视图右上角⋯→取消勾选“Show raw values”）。
附件、截图、投票数、评论全文均【不会出现在任何导出结果中】，包括API响应；这些数据只能通过Linear Web界面人工查看或借助第三方集成工具（如Zapier+Google Sheets）间接捕获。
导出的CSV文件不包含表头行的字段类型声明，Excel可能将含斜杠的版本号（如“v2.1.0”）误识别为日期，建议在Excel中导入时选择“从文本导入向导”，将对应列设为“文本”格式。
