一文吃透 Effect 结构化并发forkChild、forkDetach、forkScoped 三大纤维 API 完整指南【免费下载链接】effect-smolCore libraries and experimental work for Effect v4项目地址: https://gitcode.com/GitHub_Trending/ef/effect-smoleffect-smol是 Effect v4 的核心库与实验性代码仓库其中结构化并发structured concurrency是它最核心的能力之一通过forkChild、forkDetach、forkScoped三个 fork 系列 API你可以把耗时任务派发到独立纤维Fiber上并行执行同时确保后台任务不会失控泄漏。本文将用新手友好的方式带你快速掌握这三个 API 的区别、选择方法和常用配置项。什么是 Effect 结构化并发传统并发容易出现孤儿线程主流程结束了后台任务还在偷偷运行出了问题无处追踪。Effect 的结构化并发反其道而行——每个子任务都必须明确声明自己活在谁的生命周期里父任务结束 → 子任务自动被中断防泄漏作用域Scope关闭 → 作用域内的纤维一起收尾需要长期运行 → 显式声明分离挂到全局作用域核心思想就一句话并发可以随意开但结束时总有人负责清理。官方在 Effect.ts 文件头注释里就把 structured concurrency 列为库的四大支柱之一。四个 Fork API 一张表看懂API生命周期归属典型场景源码位置forkChild父纤维子作用域主流程内的并行子任务Effect.ts#L8546forkScoped当前Scope随作用域一起开/关的任务Effect.ts#L8642forkIn你指定的任意Scope把任务挂到别的作用域Effect.ts#L8591forkDetach全局作用域日志、心跳等守护进程Effect.ts#L8692 记忆口诀Child 跟父走Scoped 跟作用域走Detach 谁也不跟。forkChild 详解带自动监督的子纤维forkChild是最高频的 API。它把 Effect 派发到新纤维执行父纤维结束时子纤维自动被中断——官方称之为auto supervision自动监督从根本上杜绝纤维泄漏。const program Effect.gen(function*() { const fiber yield* longTask.pipe(Effect.forkChild) // 立即返回 Fiber // 主流程继续做别的事…… const result yield* Fiber.join(fiber) // 需要结果时再等待 return result })文档中还特别提醒如果只是想要两个任务并行取两者结果这类常见模式优先用更高层的组合子如zipPar、raceWith直接裸用forkChild反而是最后选择。完整的官方示例就写在 forkChild 定义上方 的注释里。⚠️ 新手最容易踩的坑fork 不等于 join。forkChild只是点火如果不join它主流程不会等它完成。forkScoped 详解与当前作用域同生共死forkScoped把纤维挂到当前Scope上作用域关闭时纤维自动被中断。它比forkChild多一个Scope环境依赖适合任务的生命周期由外部容器决定的场景例如 HTTP 请求处理期间启动的轮询、缓存刷新任务——请求结束Scope 关闭任务随之清理。const program Effect.scoped( Effect.gen(function*() { const fiber yield* backgroundTask.pipe(Effect.forkScoped) yield* Effect.sleep(1 second) // 函数返回、Scope 关闭时fiber 自动被中断 return scope completed }) )官方示例见 forkScoped 注释。forkDetach 详解独立于主流程的守护进程forkDetach把纤维挂到全局作用域——主流程结束后它依然继续运行。这是唯一逃逸出结构化并发的官方出口适合心跳上报、日志守护、全局定时器等真正需要长期存活的后台任务。const fiber yield* daemonTask.pipe(Effect.forkDetach) // 主流程 return 后daemon 仍在后台运行选择建议拿不准时默认用forkChild只有当任务确实在业务主流程结束后仍必须存活时才用forkDetach——它是 v3 中forkDaemon的新名字语义就是脱离父级生命周期。通用 Fork 配置项startImmediately 与 uninterruptiblev4 中四个 fork API 都支持统一选项对象startImmediately设为true时新纤维立即开始执行否则默认延迟启动uninterruptibletrue使纤维不可被中断inherit继承父纤维的中断策略。yield* task.pipe(Effect.forkChild({ startImmediately: true }))这个改动在 v4 迁移文档中有完整说明详见 migration/forking.md。拿到结果Fiber.join 与 Fiber.await 怎么选fork 之后你手里是一个Fiber值等待结果有两个标准入口方法返回值适用场景Fiber.join(fiber)任务的结果失败则抛出主流程需要结果Fiber.await(fiber)Exit值成功/失败都拿到只做观测、不传播错误Fiber.join定义于 Fiber.ts#L272Fiber.await则返回Exit类型适合我只想看它成没成功不影响主流程成败的监控型任务。另外Effect.awaitAllChildren可以强制当前 Effect 等所有子纤维完成后再结束定义见 Effect.ts#L8731。v3 迁移速查这些 API 改名了如果你从 Effect v3 迁移过来重点看这张改名对照表完整版在 migration/forking.mdv3v4Effect.forkEffect.forkChildEffect.forkDaemonEffect.forkDetachEffect.forkScoped不变Effect.forkAll已移除改用逐个forkChild延伸阅读与源码地图API 定义总入口packages/effect/src/Effect.tsSupervision Fibers 区块纤维与等待操作packages/effect/src/Fiber.tsv3→v4 迁移指南目录migration/可运行示例ai-docs/src/01_effect/官方测试用例fork 行为的最佳参考packages/effect/test/Effect.test.ts小结默认选forkChild子纤维跟随父级自动监督零泄漏作用域边界选forkScoped和 Scope 同生共死真·后台任务才选forkDetach挂全局作用域主流程退出后继续跑fork 只是点火记得用Fiber.join/Fiber.await收尾才是完整的结构化并发闭环。掌握这三板斧Effect v4 的并发模型对你来说就不再是黑盒了 【免费下载链接】effect-smolCore libraries and experimental work for Effect v4项目地址: https://gitcode.com/GitHub_Trending/ef/effect-smol创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
一文吃透 Effect 结构化并发：forkChild、forkDetach、forkScoped 三大纤维 API 完整指南
一文吃透 Effect 结构化并发forkChild、forkDetach、forkScoped 三大纤维 API 完整指南【免费下载链接】effect-smolCore libraries and experimental work for Effect v4项目地址: https://gitcode.com/GitHub_Trending/ef/effect-smoleffect-smol是 Effect v4 的核心库与实验性代码仓库其中结构化并发structured concurrency是它最核心的能力之一通过forkChild、forkDetach、forkScoped三个 fork 系列 API你可以把耗时任务派发到独立纤维Fiber上并行执行同时确保后台任务不会失控泄漏。本文将用新手友好的方式带你快速掌握这三个 API 的区别、选择方法和常用配置项。什么是 Effect 结构化并发传统并发容易出现孤儿线程主流程结束了后台任务还在偷偷运行出了问题无处追踪。Effect 的结构化并发反其道而行——每个子任务都必须明确声明自己活在谁的生命周期里父任务结束 → 子任务自动被中断防泄漏作用域Scope关闭 → 作用域内的纤维一起收尾需要长期运行 → 显式声明分离挂到全局作用域核心思想就一句话并发可以随意开但结束时总有人负责清理。官方在 Effect.ts 文件头注释里就把 structured concurrency 列为库的四大支柱之一。四个 Fork API 一张表看懂API生命周期归属典型场景源码位置forkChild父纤维子作用域主流程内的并行子任务Effect.ts#L8546forkScoped当前Scope随作用域一起开/关的任务Effect.ts#L8642forkIn你指定的任意Scope把任务挂到别的作用域Effect.ts#L8591forkDetach全局作用域日志、心跳等守护进程Effect.ts#L8692 记忆口诀Child 跟父走Scoped 跟作用域走Detach 谁也不跟。forkChild 详解带自动监督的子纤维forkChild是最高频的 API。它把 Effect 派发到新纤维执行父纤维结束时子纤维自动被中断——官方称之为auto supervision自动监督从根本上杜绝纤维泄漏。const program Effect.gen(function*() { const fiber yield* longTask.pipe(Effect.forkChild) // 立即返回 Fiber // 主流程继续做别的事…… const result yield* Fiber.join(fiber) // 需要结果时再等待 return result })文档中还特别提醒如果只是想要两个任务并行取两者结果这类常见模式优先用更高层的组合子如zipPar、raceWith直接裸用forkChild反而是最后选择。完整的官方示例就写在 forkChild 定义上方 的注释里。⚠️ 新手最容易踩的坑fork 不等于 join。forkChild只是点火如果不join它主流程不会等它完成。forkScoped 详解与当前作用域同生共死forkScoped把纤维挂到当前Scope上作用域关闭时纤维自动被中断。它比forkChild多一个Scope环境依赖适合任务的生命周期由外部容器决定的场景例如 HTTP 请求处理期间启动的轮询、缓存刷新任务——请求结束Scope 关闭任务随之清理。const program Effect.scoped( Effect.gen(function*() { const fiber yield* backgroundTask.pipe(Effect.forkScoped) yield* Effect.sleep(1 second) // 函数返回、Scope 关闭时fiber 自动被中断 return scope completed }) )官方示例见 forkScoped 注释。forkDetach 详解独立于主流程的守护进程forkDetach把纤维挂到全局作用域——主流程结束后它依然继续运行。这是唯一逃逸出结构化并发的官方出口适合心跳上报、日志守护、全局定时器等真正需要长期存活的后台任务。const fiber yield* daemonTask.pipe(Effect.forkDetach) // 主流程 return 后daemon 仍在后台运行选择建议拿不准时默认用forkChild只有当任务确实在业务主流程结束后仍必须存活时才用forkDetach——它是 v3 中forkDaemon的新名字语义就是脱离父级生命周期。通用 Fork 配置项startImmediately 与 uninterruptiblev4 中四个 fork API 都支持统一选项对象startImmediately设为true时新纤维立即开始执行否则默认延迟启动uninterruptibletrue使纤维不可被中断inherit继承父纤维的中断策略。yield* task.pipe(Effect.forkChild({ startImmediately: true }))这个改动在 v4 迁移文档中有完整说明详见 migration/forking.md。拿到结果Fiber.join 与 Fiber.await 怎么选fork 之后你手里是一个Fiber值等待结果有两个标准入口方法返回值适用场景Fiber.join(fiber)任务的结果失败则抛出主流程需要结果Fiber.await(fiber)Exit值成功/失败都拿到只做观测、不传播错误Fiber.join定义于 Fiber.ts#L272Fiber.await则返回Exit类型适合我只想看它成没成功不影响主流程成败的监控型任务。另外Effect.awaitAllChildren可以强制当前 Effect 等所有子纤维完成后再结束定义见 Effect.ts#L8731。v3 迁移速查这些 API 改名了如果你从 Effect v3 迁移过来重点看这张改名对照表完整版在 migration/forking.mdv3v4Effect.forkEffect.forkChildEffect.forkDaemonEffect.forkDetachEffect.forkScoped不变Effect.forkAll已移除改用逐个forkChild延伸阅读与源码地图API 定义总入口packages/effect/src/Effect.tsSupervision Fibers 区块纤维与等待操作packages/effect/src/Fiber.tsv3→v4 迁移指南目录migration/可运行示例ai-docs/src/01_effect/官方测试用例fork 行为的最佳参考packages/effect/test/Effect.test.ts小结默认选forkChild子纤维跟随父级自动监督零泄漏作用域边界选forkScoped和 Scope 同生共死真·后台任务才选forkDetach挂全局作用域主流程退出后继续跑fork 只是点火记得用Fiber.join/Fiber.await收尾才是完整的结构化并发闭环。掌握这三板斧Effect v4 的并发模型对你来说就不再是黑盒了 【免费下载链接】effect-smolCore libraries and experimental work for Effect v4项目地址: https://gitcode.com/GitHub_Trending/ef/effect-smol创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考