Linear支持通过本地命令行工具批量导入Jira、GitHub、Trello数据：需克隆仓库、pnpm安装依赖并构建；按平台选择对应importer命令；导入后须检查映射摘要与.import-log日志确保无错。
在Linear项目中使用导入功能，可将Jira、GitHub、Trello等外部平台的历史任务数据批量迁移到Linear工作区，避免手动重建耗时且易出错。该功能依赖本地运行的命令行工具，不通过网页界面操作，必须先完成项目克隆与依赖安装。
准备导入环境
克隆Linear开源仓库并进入项目根目录：
【git clone https://github.com/linear/linear.git && cd linear】
使用pnpm安装全部工作区依赖（注意：yarn或npm可能因Lerna配置导致链接失败）：
pnpm install
构建所有子包，确保import工具可执行：
pnpm build
选择并执行对应导入器
Linear的导入工具位于packages/import/目录下，按源平台分模块组织。运行前需确认目标数据格式与路径是否匹配。
方法一：从Jira CSV文件导入
确保CSV文件包含必需列（如Summary、Description、Status、Assignee），且编码为UTF-8：
pnpm import --file ./jira_export.csv --importer jiraCsv
方法二：从GitHub Issues JSON导入
需提前用GitHub API导出issues为JSON数组格式，字段名须含title、body、state、user.login：
pnpm import --file ./gh_issues.json --importer github
方法三：从Trello导出的JSON导入
Trello导出文件必须为单个看板的完整JSON（含cards、lists、members），不能是压缩包或分片文件：
pnpm import --file ./trello_board.json --importer trelloJson
验证与调试导入过程
第一步：启用详细日志输出，定位字段映射异常
pnpm import --file data.csv --importer jiraCsv --verbose
第二步：检查控制台输出的“Mapping summary”段落，确认关键字段（如status → state、assignee → assigneeId）是否自动识别成功。若出现Unmapped field: priority，说明CSV中priority列未被识别，需手动在importer代码中扩展映射逻辑。
第三步：导入完成后，查看.import-log文件，确认error计数为0且created/updated数量符合预期。该日志默认生成在项目根目录，不可跳过检查。
