必须通过Issue Relations功能显式建立依赖,而非文字描述或手动表格;单向依赖需在被依赖方(B)上添加对A的“Blocks”关系;批量操作支持多选右键或CLI命令;解除依赖可单点点击“×”或CSV导入清理,但需提前备份。

在Linear中管理任务之间的先后顺序和阻塞关系,必须通过Issue Relations功能显式建立依赖,而不是靠文字描述或手动维护表格——否则依赖状态不会自动更新,也无法触发阻塞提醒。
添加单向依赖(A依赖B)
打开需要被依赖的Issue(即“前置任务”B),点击右侧栏「Relations」→「Add relation」→ 在弹出框中输入目标Issue编号(如issue-123)或关键词搜索 → 选择「Blocks」类型 → 点击「Add」。
这一步完成后,B会显示「Blocked by 1 issue」,而A会显示「Blocks 1 issue」。注意:Linear中依赖是单向声明的,【必须在被依赖方(B)上主动添加对A的“Blocks”关系,A本身不会自动生成反向依赖】。
批量建立多个依赖
方法一:在Issue列表页按住Ctrl(Windows)或Cmd(Mac)多选多个Issue → 右键 → 「Add relation to selected」→ 输入前置Issue编号 → 选择「Blocks」→ 确认。
方法二:使用Linear CLI工具,在终端执行:linear-cli issue relate --issue "issue-456" --relation "blocks" --target "issue-123,issue-234"。该命令需提前完成身份认证并安装CLI。
查看与解除依赖关系
第一步:打开任意已存在依赖的Issue → 滚动到右侧Relations面板 → 找到「Blocks」或「Blocked by」分组下的关联项。
第二步:将鼠标悬停在对应关系条目右侧 → 点击出现的「×」图标即可立即解除该依赖。
第三步:若需批量清理,可导出当前Project所有Issue为CSV,在「relations」列手动清空后重新导入(导入时勾选「Update existing issues」)。此操作不可逆,【导入前务必备份原始数据】。
依赖状态自动同步规则
当被依赖的Issue(B)状态变为「Done」,所有明确声明「Blocks」它的Issue(A)会自动解除阻塞状态,并在A的标题左侧显示绿色对勾图标。
如果B被重新打开(从Done变回In Progress等),A不会自动恢复阻塞——必须人工再次添加关系。Linear不支持双向状态联动。
依赖关系不继承:A依赖B、B依赖C,不代表A自动依赖C。每层依赖都必须独立声明。

















