术语表 社区共识

原则很简单：核心术语保留英文，不发明新词 —— 这样你读中文文档时能对得上官方文档、搜索结果和社区讨论。 首次出现时给一句中文解释即可。下表欢迎通过 PR 提案修订（见 docs/glossary.json）。

术语（保留英文）	中文说明	备注
Effect	效应/效果（库名不翻译）	作为库名时保留 Effect，不要译为“效果系统”“作用”
Effect.gen	生成器写法	API 名保留英文
Fiber	轻量级协程（保留英文）	不译为“纤维”
Layer	依赖层（保留英文）	不译为“图层”
Schema	模式/结构（保留英文）	指 @effect/schema 时保留 Schema
Stream	流（保留英文）	Effect 的流式数据类型
Sink	汇（保留英文）	—
Scope	作用域	—
Service	服务	Context.Tag 声明的依赖
Context	上下文	依赖注入的容器
Runtime	运行时	—
Cause	失败原因	Effect 的错误/缺陷统一表示
Exit	执行结果	—
Option	可选值（保留英文）	—
Either	二选一（保留英文）	—
Ref	可变引用	Effect 的并发安全可变状态
Queue	队列	—
PubSub	发布订阅	—
Deferred	延迟承诺	—
Schedule	调度策略	—
Retry	重试	—
Interruption	中断	结构化并发的取消语义
Structured Concurrency	结构化并发	—
Tagged Error	带标签的错误	Data.TaggedError：可判别联合的错误
Branded Type	品牌类型	用 Brand 在类型层面区分同构字符串/数字
side effect	副作用	—
tree shaking	摇树优化	通常直接写 tree shaking 亦可
dependency injection	依赖注入	—

这些译法会被 CI 直接拦下

为了避免读者对不上官方文档，下面这些"自创译名"在译文里出现即导致 PR 失败（内容门禁 pnpm content:check）：

• 纤维 → 应写 Fiber
• 图层 → 应写 Layer
• 效果系统 → 应写 Effect

想新增/修改规则？直接给 docs/glossary.json 提 PR —— 改完 CI 立刻生效。