在linear中创建issue是项目管理的起点，可通过网页端新建、克隆、快捷键或api四种方式实现，分别适用于日常录入、复用任务、快速触发和批量导入场景。
在Linear中创建Issue是项目管理中最基础的操作，直接决定后续任务分配、进度追踪和团队协作的起点。没有Issue，整个工作流就无法启动，所有子任务、时间估算和状态变更都无从谈起。
通过Linear网页端新建Issue
打开Linear官网并登录你的工作区，确保你已加入目标团队（Team）且拥有“Member”或更高权限。
在左侧导航栏点击目标团队名称 → 顶部菜单栏选择“New issue”按钮（绿色加号图标）。
在弹出的表单中，【必须填写标题】，这是Issue唯一不可为空的字段；正文可选，但建议用1–2句话说明背景或上下文。
右侧边栏会自动展开属性面板：可设置Assignee（负责人）、Label（标签）、Priority（优先级）、Status（状态，默认为Backlog）、Cycle（迭代周期）等。其中Label需提前在团队设置中创建，未定义的标签无法手动输入。
点击右上角“Create issue”完成提交——该Issue将立即出现在当前团队的默认视图（如Board或List）中，并同步推送通知给被指派者（如果设置了Assignee）。
从已有Issue快速克隆一个新Issue
当你需要复用相似结构的任务（比如同一功能的多个端适配），克隆比重填更高效。
打开原始Issue → 点击右上角“⋯”更多操作 → 选择“Duplicate issue”。
系统会自动生成副本，保留原Issue的标题前缀（如“[Copy]”）、全部描述、Assignee、Labels和Status，但【不继承任何子Issue、评论、附件或时间记录】。
编辑标题和描述以反映新任务差异，确认后点击“Save”即可发布。
用快捷键在任意页面触发新建
无论当前在Linear哪个页面（Dashboard、Project、Issue详情页），按下 Cmd/Ctrl + K 即可呼出全局命令面板。
输入“new issue”，回车后进入新建流程，焦点自动落在标题输入框。
这一步操作起来很简单，直接把文件拖进去就行。
通过API批量创建Issue（适用于迁移或自动化场景）
如果你需要一次性导入上百个Issue（例如从Jira或Excel迁移），必须使用Linear REST API。
第一步：前往Linear Settings → Developer settings → Generate new API key，复制密钥并保存到安全位置。
第二步：构造POST请求到 https://api.linear.app/v1/issues，Header中添加 Authorization: Bearer <your_api_key></your_api_key>，Body中传入JSON对象，至少包含 title 和 teamId 字段。
第三步：发送请求。成功响应返回201，且body中含新Issue的ID和URL；若返回400，检查teamId是否拼写错误或权限不足——【teamId不是团队名称，而是12位字母数字字符串，可在团队URL末尾找到】。
注意：API创建的Issue不会触发通知，也不会自动关联到Project，需额外调用/issue/{id}/moveToProject接口补全。
