effect-smol迁移FiberRef到Context.Reference全解【免费下载链接】effect-smolCore libraries and experimental work for Effect v4项目地址: https://gitcode.com/GitHub_Trending/ef/effect-smol本文带你快速掌握effect-smolEffect v4 核心库中最重要的迁移点之一v3 的FiberRef已完全移除Fiber 本地状态统一由Context.Reference接管。这是一份面向新手的完整迁移指南涵盖 9 个内置引用的对照表、读取/修改/作用域更新三大操作以及最容易踩坑的地方帮你一次性把 v3 代码平滑升级到 v4。一、为什么 FiberRef 被移除了在 Effect v3 中FiberRef是管理Fiber 本地状态的专用机制——日志级别、并发度、调度器等都靠它。进入 v4 后FiberRef、FiberRefs、FiberRefsPatch、Differ四个模块全部删除。变化背后的思路很简单Reference 不再是一个特殊对象而是带默认值的服务Service。 一句话理解Reference 有默认值的服务键。读取它就像注入依赖修改它就像在局部范围覆盖注入。官方迁移文档位于 fiberref.md完整映射关系见 v3-to-v4.md。二、核心概念Context.Reference 是什么Context.Reference定义在 Context.ts 中用法如下const LoggerRef Context.Reference(Logger, { defaultValue: () ({ log: (msg: string) console.log(msg) }) })它的三个关键特性有默认值即使上下文为空也能读到默认值默认值惰性计算并缓存可被覆盖通过Effect.provideService在指定范围内提供新值自动向下传递被覆盖的值会作用于该 Effect 及其派生的所有子 Fiberv3 的所有内置 FiberRef 现在统一从References模块导出源码在 References.ts。三、9 个内置引用v3 → v4 对照表这是迁移时最常查的速查表来自 fiberref.mdv3 FiberRefv4 ReferenceReferences.*用途FiberRef.currentConcurrencyCurrentConcurrency并发上限FiberRef.currentLogLevelCurrentLogLevel当前日志级别FiberRef.currentMinimumLogLevelMinimumLogLevel最低日志级别过滤FiberRef.currentLogAnnotationsCurrentLogAnnotations日志注解FiberRef.currentLogSpanCurrentLogSpans日志跨度栈FiberRef.currentSchedulerScheduler调度器实例FiberRef.currentMaxOpsBeforeYieldMaxOpsBeforeYield让出调度前的操作预算FiberRef.currentTracerEnabledTracerEnabled是否启用追踪FiberRef.unhandledErrorLogLevelUnhandledLogLevel未处理错误的日志级别四、三大操作的迁移写法1️⃣ 读取引用FiberRef.get→ 直接yield*v4 中 Reference 就是服务直接用生成器语法读取// v3: const level yield* FiberRef.get(FiberRef.currentLogLevel) // v4: 直接 yield* 即可 const level yield* References.CurrentLogLevel // Info默认值2️⃣ 作用域更新Effect.locally→Effect.provideServicev3 的Effect.locally在一段时间内临时修改引用值v4 统一改用Effect.provideService// v3: Effect.locally(myEffect, FiberRef.currentLogLevel, LogLevel.Debug) // v4: Effect.provideService(myEffect, References.CurrentLogLevel, Debug)⚠️ 注意两点差异日志级别在 v4 中是字符串Debug不再是LogLevel.Debug常量值的生效范围是被提供的 Effect 及其子 Fiber不是当前 Fiber 剩余时间3️⃣ 写入引用FiberRef.set→ 同样用Effect.provideServicev3 的FiberRef.set是可变的——改一次后续全可见。v4 是纯函数式的——值只在提供的范围内生效// v3: yield* FiberRef.set(FiberRef.currentConcurrency, 10) // 之后一直可见 // v4: 值只作用于传入的 Effect Effect.provideService( Effect.gen(function*() { const concurrency yield* References.CurrentConcurrency // 10 }), References.CurrentConcurrency, 10 )五、创建自己的 Referencev4 的一大福利你可以像创建普通服务一样创建自定义 Reference见 Context.ts 的Reference工厂函数const TraceId Context.Reference(TraceId, { defaultValue: () - })在业务代码中按需覆盖就能实现类似 v3 时代的请求链路追踪上下文传递且行为完全符合依赖注入的心智模型。六、迁移清单与常见坑✅迁移检查清单全局搜索FiberRef、FiberRefs、Differ全部替换effect/FiberRef导入改为effect/References导入映射见 v3-to-v4.mdEffect.locally替换为Effect.provideService参数顺序为(effect, reference, value)检查LogLevel.X常量 → 字符串字面量⚠️最容易踩的 2 个坑语义差异v3 的FiberRef.set影响当前 Fiber 之后的所有代码v4 没有全局可变写入只能为某个 Effect 提供值。若旧代码依赖 set 的后续可见性需要重构为 provideService 包裹默认值缓存Reference 的默认值是惰性求值并缓存的如果你的默认值依赖外部可变状态需要留意缓存行为七、相关资料迁移主文档fiberref.md完整 v3→v4 模块与 API 映射290 个模块、53 处重命名v3-to-v4.md内置 Reference 定义与使用示例References.tsContext.Reference工厂函数实现Context.tsprovideServiceAPI 文档Effect.ts 掌握Context.Reference 带默认值的服务这一心智模型FiberRef 迁移就没有难度了读就是yield*改就是provideService其他全部按对照表替换即可。【免费下载链接】effect-smolCore libraries and experimental work for Effect v4项目地址: https://gitcode.com/GitHub_Trending/ef/effect-smol创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
